# naver/naveridlogin-sdk-android architecture

> Architecture diagram of the GitHub repository naver/naveridlogin-sdk-android, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/naver/naveridlogin-sdk-android
- Repository: https://github.com/naver/naveridlogin-sdk-android

## Overview

This Android SDK lets a client app initialize Naver Login, authenticate a user through the Naver app or a Chrome Custom Tab, exchange the returned authorization code for tokens, and manage login state and user profiles. The public SDK coordinates OAuth use cases; a bridge activity owns the interactive authorization handoff, while repositories connect domain operations to remote APIs and local token storage. The README also identifies login, logout, and token management as core capabilities. Several profile and logout details are not excerpted, so only documented or indexed relationships are shown.

Main entry points: [`Nid-OAuth/src/main/java/com/navercorp/nid/NidOAuth.kt`](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/NidOAuth.kt) (SDK Facade), [`Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthBridgeActivity.kt`](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthBridgeActivity.kt) (Login Bridge), [`Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/repository/NidOAuthRepository.kt`](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/repository/NidOAuthRepository.kt) (OAuth Data Repository), [`Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/repository/NidUserProfileRepository.kt`](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/repository/NidUserProfileRepository.kt) (Profile Repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["SDK API"]
  node_sdk["SDK Facade<br/>[NidOAuth.kt]"]
  node_login_api["Login API<br/>[NidOAuthLogin.kt]"]
end

subgraph group_auth["OAuth Login"]
  node_bridge["Login Bridge"]
  node_intent["OAuth Intent<br/>[NidOAuthIntent.kt]"]
  node_customtab["Custom Tab"]
  node_viewmodel["Bridge ViewModel"]
  node_login_ui["Login Button UI"]
end

subgraph group_domain["OAuth Domain"]
  node_login_usecase["Login Use Case<br/>[Login.kt]"]
  node_oauth_usecases["Token and Client Use Cases<br/>[GetOAuthInfo.kt]"]
  node_oauth_repository["OAuth Repository<br/>[OAuthRepository.kt]"]
end

subgraph group_data["Persistence and APIs"]
  node_oauth_impl["OAuth Data Repository"]
  node_oauth_remote["OAuth Remote Source"]
  node_oauth_service["Token API Service"]
  node_local_source[("Local OAuth Data")]
  node_service_locator["Dependency Wiring"]
end

subgraph group_profile["User Profile"]
  node_profile_usecase["Fetch Profile"]
  node_profile_impl["Profile Repository"]
  node_profile_remote["Profile Remote Source"]
  node_profile_service["Profile API Service"]
end

node_client(("Client App"))
node_naver(("Naver Login Service"))
node_profile_api(("Naver Profile API"))

node_client -->|"initializes and calls"| node_sdk
node_login_api -->|"launches login"| node_bridge
node_bridge -->|"requests login"| node_viewmodel
node_bridge -->|"launches fallback"| node_customtab
node_bridge -->|"uses intent"| node_intent
node_login_ui -.->|"starts login"| node_login_api
node_viewmodel -.->|"invokes"| node_login_usecase
node_sdk -.->|"reads token state"| node_oauth_usecases
node_sdk -.->|"fetches profile"| node_profile_usecase
node_sdk -->|"provides repository"| node_oauth_impl
node_service_locator -->|"provides repository"| node_oauth_impl
node_service_locator -->|"provides repository"| node_profile_impl
node_oauth_impl -->|"requests tokens"| node_oauth_remote
node_oauth_impl -->|"reads and writes"| node_local_source
node_oauth_remote -.->|"calls token API"| node_oauth_service
node_oauth_service -->|"requests tokens"| node_naver
node_profile_usecase -.->|"fetches profile"| node_profile_impl
node_profile_impl -.->|"loads profile"| node_profile_remote
node_profile_remote -.->|"calls profile API"| node_profile_service
node_profile_service -->|"requests profile"| node_profile_api

click node_sdk "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/NidOAuth.kt"
click node_login_api "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/NidOAuthLogin.kt"
click node_bridge "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthBridgeActivity.kt"
click node_intent "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthIntent.kt"
click node_customtab "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthCustomTabActivity.kt"
click node_viewmodel "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/viewModel/NidOAuthBridgeViewModel.kt"
click node_login_ui "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/view/NidOAuthLoginButton.kt"
click node_login_usecase "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/domain/usecase/Login.kt"
click node_oauth_usecases "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/domain/usecase/GetOAuthInfo.kt"
click node_oauth_repository "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/domain/repository/OAuthRepository.kt"
click node_oauth_impl "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/repository/NidOAuthRepository.kt"
click node_oauth_remote "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/datasource/NidOAuthRemoteDataSource.kt"
click node_oauth_service "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/service/NidOAuthLoginService.kt"
click node_local_source "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/core/data/datastore/NidOAuthLocalDataSource.kt"
click node_service_locator "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/NidServiceLocator.kt"
click node_profile_usecase "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/profile/domain/usecase/FetchUserProfile.kt"
click node_profile_impl "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/repository/NidUserProfileRepository.kt"
click node_profile_remote "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/datasource/NidProfileRemoteDataSource.kt"
click node_profile_service "https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/service/NidProfileService.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_sdk,node_login_api,node_client toneBlue
class node_bridge,node_intent,node_customtab,node_viewmodel,node_login_ui toneAmber
class node_login_usecase,node_oauth_usecases,node_oauth_repository,node_profile_api toneMint
class node_oauth_impl,node_oauth_remote,node_oauth_service,node_local_source,node_service_locator toneRose
class node_profile_usecase,node_profile_impl,node_profile_remote,node_profile_service,node_naver toneIndigo
```

## Components

### SDK API

- [SDK Facade](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/NidOAuth.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/NidOAuth.kt`
- [Login API](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/NidOAuthLogin.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/NidOAuthLogin.kt`

### OAuth Login

- [Login Bridge](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthBridgeActivity.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthBridgeActivity.kt`
- [OAuth Intent](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthIntent.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthIntent.kt`
- [Custom Tab](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthCustomTabActivity.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthCustomTabActivity.kt`
- [Bridge ViewModel](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/viewModel/NidOAuthBridgeViewModel.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/viewModel/NidOAuthBridgeViewModel.kt`
- [Login Button UI](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/view/NidOAuthLoginButton.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/view/NidOAuthLoginButton.kt`

### OAuth Domain

- [Login Use Case](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/domain/usecase/Login.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/domain/usecase/Login.kt`
- [Token and Client Use Cases](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/domain/usecase/GetOAuthInfo.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/domain/usecase/GetOAuthInfo.kt`
- [OAuth Repository](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/domain/repository/OAuthRepository.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/domain/repository/OAuthRepository.kt`

### Persistence and APIs

- [OAuth Data Repository](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/repository/NidOAuthRepository.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/repository/NidOAuthRepository.kt`
- [OAuth Remote Source](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/datasource/NidOAuthRemoteDataSource.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/datasource/NidOAuthRemoteDataSource.kt`
- [Token API Service](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/service/NidOAuthLoginService.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/service/NidOAuthLoginService.kt`
- [Local OAuth Data](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/core/data/datastore/NidOAuthLocalDataSource.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/core/data/datastore/NidOAuthLocalDataSource.kt`
- [Dependency Wiring](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/NidServiceLocator.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/NidServiceLocator.kt`

### User Profile

- [Fetch Profile](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/profile/domain/usecase/FetchUserProfile.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/profile/domain/usecase/FetchUserProfile.kt`
- [Profile Repository](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/repository/NidUserProfileRepository.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/repository/NidUserProfileRepository.kt`
- [Profile Remote Source](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/datasource/NidProfileRemoteDataSource.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/datasource/NidProfileRemoteDataSource.kt`
- [Profile API Service](https://github.com/naver/naveridlogin-sdk-android/blob/master/Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/service/NidProfileService.kt): `Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/service/NidProfileService.kt`

### Other components

- **Client App**
- **Naver Login Service**
- **Naver Profile API**

## Connections

- Client App → SDK Facade: initializes and calls (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/NidOAuth.kt`)
- Login API → Login Bridge: launches login (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/NidOAuthLogin.kt`)
- Login Bridge → Bridge ViewModel: requests login (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthBridgeActivity.kt`)
- Login Bridge → Custom Tab: launches fallback (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthBridgeActivity.kt`)
- Login Bridge → OAuth Intent: uses intent (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/activity/NidOAuthBridgeActivity.kt`)
- Login Button UI → Login API: starts login
- Bridge ViewModel → Login Use Case: invokes (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/viewModel/NidOAuthBridgeViewModel.kt`)
- SDK Facade → Token and Client Use Cases: reads token state (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/NidOAuth.kt`)
- SDK Facade → Fetch Profile: fetches profile (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/NidOAuth.kt`)
- SDK Facade → OAuth Data Repository: provides repository
- Dependency Wiring → OAuth Data Repository: provides repository (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/NidServiceLocator.kt`)
- Dependency Wiring → Profile Repository: provides repository (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/NidServiceLocator.kt`)
- OAuth Data Repository → OAuth Remote Source: requests tokens (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/repository/NidOAuthRepository.kt`)
- OAuth Data Repository → Local OAuth Data: reads and writes (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/repository/NidOAuthRepository.kt`)
- OAuth Remote Source → Token API Service: calls token API (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/datasource/NidOAuthRemoteDataSource.kt`)
- Token API Service → Naver Login Service: requests tokens (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/oauth/data/service/NidOAuthLoginService.kt`)
- Fetch Profile → Profile Repository: fetches profile
- Profile Repository → Profile Remote Source: loads profile (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/repository/NidUserProfileRepository.kt`)
- Profile Remote Source → Profile API Service: calls profile API (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/datasource/NidProfileRemoteDataSource.kt`)
- Profile API Service → Naver Profile API: requests profile (evidence: `Nid-OAuth/src/main/java/com/navercorp/nid/profile/data/service/NidProfileService.kt`)
