# protonvpn/android-app architecture

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

- Interactive diagram: https://gitdiagram.com/protonvpn/android-app
- Repository: https://github.com/protonvpn/android-app

## Overview

ProtonVPN for Android is a client for account-backed VPN connections. The core runtime coordinates user/session state, server inventory, connection state, and a WireGuard service; Android Quick Settings can also expose connection controls. The repository tree documents adjacent capabilities including app configuration updates, profiles, excluded locations, bug reporting, managed auto-login, and Google-specific promotional offers. Source excerpts establish several internal calls, but most screens and connection orchestration were not sampled, so their relationships are intentionally not inferred.

Main entry points: [`app/src/main/java/com/protonvpn/android/vpn/wireguard/WireguardWrapperService.kt`](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/vpn/wireguard/WireguardWrapperService.kt) (WireGuard service), [`app/src/main/java/com/protonvpn/android/appconfig/periodicupdates/PeriodicUpdateManager.kt`](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/appconfig/periodicupdates/PeriodicUpdateManager.kt) (Periodic updates), [`app/src/main/java/com/protonvpn/android/auth/usecase/CurrentUser.kt`](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/auth/usecase/CurrentUser.kt) (Current user state), [`app/src/main/java/com/protonvpn/android/managed/AutoLoginManager.kt`](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/managed/AutoLoginManager.kt) (Managed auto-login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_connection["VPN connection"]
  node_quicktile["Quick Settings tile"]
  node_tiledata[("Tile state store")]
  node_wireguard["WireGuard service"]
  node_connmanager["Connection manager"]
  node_vpnstate["VPN state monitor<br/>[VpnStateMonitor.kt]"]
  node_servers["Server inventory"]
  node_serverstore[("Server store")]
  node_certs[("VPN certificates")]
end

subgraph group_account["Account and access"]
  node_currentuser["Current user state<br/>[CurrentUser.kt]"]
  node_userdb[("VPN user database<br/>[VpnUserDatabase.kt]")]
  node_autologin["Managed auto-login"]
  node_authui["Account screens"]
end

subgraph group_data["App data and updates"]
  node_api["VPN API client<br/>[VpnApiClient.kt]"]
  node_appconfig["App configuration<br/>[AppConfig.kt]"]
  node_periodic["Periodic updates"]
  node_periodicdb[("Update schedule store")]
  node_localstore[("Local data store")]
end

subgraph group_features["Client features"]
  node_profiles["Connection profiles<br/>[ProfileManager.kt]"]
  node_excluded["Excluded locations"]
  node_bugreport["Bug reporting"]
  node_promo["Promotional offers"]
end

node_person(("VPN user"))

node_person -.->|"controls"| node_quicktile
node_quicktile -->|"observes state"| node_tiledata
node_wireguard -->|"notifies lifecycle"| node_connmanager
node_wireguard -->|"checks state"| node_vpnstate
node_wireguard -->|"reads account"| node_currentuser
node_servers -->|"uses store"| node_serverstore
node_person -.->|"signs in"| node_authui
node_currentuser -->|"loads user data"| node_userdb
node_autologin -->|"checks account"| node_currentuser
node_autologin -->|"resets UI"| node_authui
node_periodic -->|"tracks updates"| node_periodicdb
node_periodic -.->|"refreshes config"| node_appconfig
node_periodic -.->|"calls API"| node_api
node_certs -->|"persists certificates"| node_localstore

click node_quicktile "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/components/QuickTileService.kt"
click node_tiledata "https://github.com/protonvpn/android-app/tree/master/app/src/main/java/com/protonvpn/android/quicktile"
click node_wireguard "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/vpn/wireguard/WireguardWrapperService.kt"
click node_connmanager "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/vpn/VpnConnectionManager.kt"
click node_vpnstate "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/vpn/VpnStateMonitor.kt"
click node_servers "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/servers/ServersDataManager.kt"
click node_serverstore "https://github.com/protonvpn/android-app/tree/master/app/src/main/java/com/protonvpn/android/servers"
click node_currentuser "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/auth/usecase/CurrentUser.kt"
click node_userdb "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/auth/data/VpnUserDatabase.kt"
click node_autologin "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/managed/AutoLoginManager.kt"
click node_authui "https://github.com/protonvpn/android-app/tree/master/app/src/main/java/com/protonvpn/android/auth/ui"
click node_api "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/api/VpnApiClient.kt"
click node_appconfig "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/appconfig/AppConfig.kt"
click node_periodic "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/appconfig/periodicupdates/PeriodicUpdateManager.kt"
click node_periodicdb "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/appconfig/periodicupdates/PeriodicUpdatesDao.kt"
click node_profiles "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/userstorage/ProfileManager.kt"
click node_excluded "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/excludedlocations/usecases/ObserveExcludedLocations.kt"
click node_bugreport "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/bugreport/PrepareAndPostBugReport.kt"
click node_promo "https://github.com/protonvpn/android-app/blob/master/app/src/google/java/com/protonvpn/android/promooffers/usecase/GetEligibleOffers.kt"
click node_certs "https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/vpn/CertificateStorage.kt"
click node_localstore "https://github.com/protonvpn/android-app/tree/master/app/src/main/java/com/protonvpn/android/userstorage"

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_quicktile,node_tiledata,node_wireguard,node_connmanager,node_vpnstate,node_servers,node_serverstore,node_certs,node_person toneBlue
class node_currentuser,node_userdb,node_autologin,node_authui toneAmber
class node_api,node_appconfig,node_periodic,node_periodicdb,node_localstore toneMint
class node_profiles,node_excluded,node_bugreport,node_promo toneRose
```

## Components

### VPN connection

- [Quick Settings tile](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/components/QuickTileService.kt): `app/src/main/java/com/protonvpn/android/components/QuickTileService.kt`
- [Tile state store](https://github.com/protonvpn/android-app/tree/master/app/src/main/java/com/protonvpn/android/quicktile): `app/src/main/java/com/protonvpn/android/quicktile`
- [WireGuard service](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/vpn/wireguard/WireguardWrapperService.kt): `app/src/main/java/com/protonvpn/android/vpn/wireguard/WireguardWrapperService.kt`
- [Connection manager](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/vpn/VpnConnectionManager.kt): `app/src/main/java/com/protonvpn/android/vpn/VpnConnectionManager.kt`
- [VPN state monitor](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/vpn/VpnStateMonitor.kt): `app/src/main/java/com/protonvpn/android/vpn/VpnStateMonitor.kt`
- [Server inventory](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/servers/ServersDataManager.kt): `app/src/main/java/com/protonvpn/android/servers/ServersDataManager.kt`
- [Server store](https://github.com/protonvpn/android-app/tree/master/app/src/main/java/com/protonvpn/android/servers): `app/src/main/java/com/protonvpn/android/servers`
- [VPN certificates](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/vpn/CertificateStorage.kt): `app/src/main/java/com/protonvpn/android/vpn/CertificateStorage.kt`

### Account and access

- [Current user state](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/auth/usecase/CurrentUser.kt): `app/src/main/java/com/protonvpn/android/auth/usecase/CurrentUser.kt`
- [VPN user database](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/auth/data/VpnUserDatabase.kt): `app/src/main/java/com/protonvpn/android/auth/data/VpnUserDatabase.kt`
- [Managed auto-login](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/managed/AutoLoginManager.kt): `app/src/main/java/com/protonvpn/android/managed/AutoLoginManager.kt`
- [Account screens](https://github.com/protonvpn/android-app/tree/master/app/src/main/java/com/protonvpn/android/auth/ui): `app/src/main/java/com/protonvpn/android/auth/ui`

### App data and updates

- [VPN API client](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/api/VpnApiClient.kt): `app/src/main/java/com/protonvpn/android/api/VpnApiClient.kt`
- [App configuration](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/appconfig/AppConfig.kt): `app/src/main/java/com/protonvpn/android/appconfig/AppConfig.kt`
- [Periodic updates](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/appconfig/periodicupdates/PeriodicUpdateManager.kt): `app/src/main/java/com/protonvpn/android/appconfig/periodicupdates/PeriodicUpdateManager.kt`
- [Update schedule store](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/appconfig/periodicupdates/PeriodicUpdatesDao.kt): `app/src/main/java/com/protonvpn/android/appconfig/periodicupdates/PeriodicUpdatesDao.kt`
- [Local data store](https://github.com/protonvpn/android-app/tree/master/app/src/main/java/com/protonvpn/android/userstorage): `app/src/main/java/com/protonvpn/android/userstorage`

### Client features

- [Connection profiles](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/userstorage/ProfileManager.kt): `app/src/main/java/com/protonvpn/android/userstorage/ProfileManager.kt`
- [Excluded locations](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/excludedlocations/usecases/ObserveExcludedLocations.kt): `app/src/main/java/com/protonvpn/android/excludedlocations/usecases/ObserveExcludedLocations.kt`
- [Bug reporting](https://github.com/protonvpn/android-app/blob/master/app/src/main/java/com/protonvpn/android/bugreport/PrepareAndPostBugReport.kt): `app/src/main/java/com/protonvpn/android/bugreport/PrepareAndPostBugReport.kt`
- [Promotional offers](https://github.com/protonvpn/android-app/blob/master/app/src/google/java/com/protonvpn/android/promooffers/usecase/GetEligibleOffers.kt): `app/src/google/java/com/protonvpn/android/promooffers/usecase/GetEligibleOffers.kt`

### Other components

- **VPN user**

## Connections

- VPN user → Quick Settings tile: controls
- Quick Settings tile → Tile state store: observes state (evidence: `app/src/main/java/com/protonvpn/android/components/QuickTileService.kt`)
- WireGuard service → Connection manager: notifies lifecycle (evidence: `app/src/main/java/com/protonvpn/android/vpn/wireguard/WireguardWrapperService.kt`)
- WireGuard service → VPN state monitor: checks state (evidence: `app/src/main/java/com/protonvpn/android/vpn/wireguard/WireguardWrapperService.kt`)
- WireGuard service → Current user state: reads account (evidence: `app/src/main/java/com/protonvpn/android/vpn/wireguard/WireguardWrapperService.kt`)
- Server inventory → Server store: uses store (evidence: `app/src/main/java/com/protonvpn/android/servers/ServersDataManager.kt`)
- VPN user → Account screens: signs in
- Current user state → VPN user database: loads user data (evidence: `app/src/main/java/com/protonvpn/android/auth/usecase/CurrentUser.kt`)
- Managed auto-login → Current user state: checks account (evidence: `app/src/main/java/com/protonvpn/android/managed/AutoLoginManager.kt`)
- Managed auto-login → Account screens: resets UI (evidence: `app/src/main/java/com/protonvpn/android/managed/AutoLoginManager.kt`)
- Periodic updates → Update schedule store: tracks updates (evidence: `app/src/main/java/com/protonvpn/android/appconfig/periodicupdates/PeriodicUpdateManager.kt`)
- Periodic updates → App configuration: refreshes config
- Periodic updates → VPN API client: calls API
- VPN certificates → Local data store: persists certificates (evidence: `app/src/main/java/com/protonvpn/android/vpn/CertificateStorage.kt`)
