# rbn-apps/quick-tile-settings architecture

> Architecture diagram of the GitHub repository rbn-apps/quick-tile-settings, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rbn-apps/quick-tile-settings
- Repository: https://github.com/rbn-apps/quick-tile-settings

## Overview

Quick-Tile Settings is an Android app for controlling Private DNS and USB Debugging through Quick Settings tiles, with configuration, automation, shortcuts, and permission guidance. Users configure DNS hostnames and tile behavior in the Compose settings UI; tile services apply system changes, while optional monitoring services automate DNS policies across VPN and network changes. Settings are persisted locally and also support backup/restore. The graph uses README and indexed excerpts; unsampled capabilities are included where the tree and README support them, but their internal call paths are not asserted.

Main entry points: [`app/src/main/java/com/rbn/qtsettings/services/PrivateDnsTileService.kt`](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/services/PrivateDnsTileService.kt) (Private DNS tile), [`app/src/main/java/com/rbn/qtsettings/viewmodel/MainViewModel.kt`](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/viewmodel/MainViewModel.kt) (Settings model), [`app/src/main/java/com/rbn/qtsettings/data/PreferencesManager.kt`](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/data/PreferencesManager.kt) (Preferences), [`app/src/main/java/com/rbn/qtsettings/services/UsbDebuggingTileService.kt`](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/services/UsbDebuggingTileService.kt) (USB debugging tile)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Settings and data"]
  node_preferences[("Preferences")]
  node_dns_entries["DNS entries"]
  node_wifi_rules["Wi-Fi DNS rules<br/>[WifiDnsRule.kt]"]
  node_backup["Settings backup<br/>[SettingsBackup.kt]"]
  node_backup_parser["Backup parser"]
end

subgraph group_dns_control["DNS controls"]
  node_dns_tile["Private DNS tile"]
  node_dns_cycle["DNS cycle policy<br/>[DnsCyclePolicy.kt]"]
end

subgraph group_usb_control["USB controls"]
  node_usb_tile["USB debugging tile"]
  node_revert["Auto-revert"]
end

subgraph group_automation["Network automation"]
  node_network_service["Network monitor"]
  node_vpn_service["VPN monitor"]
  node_network_detection["Network detection"]
  node_vpn_detection["VPN detection"]
  node_dns_automation["DNS automation"]
end

subgraph group_app_entry["App experience"]
  node_main_activity["Main activity<br/>[MainActivity.kt]"]
  node_settings_ui["Settings UI<br/>[MainScreen.kt]"]
  node_settings_viewmodel["Settings model<br/>[MainViewModel.kt]"]
  node_permission_help["Permission guidance"]
  node_permission_utils["Permission checks<br/>[PermissionUtils.kt]"]
  node_shortcuts["Shortcut actions"]
  node_quick_actions["Quick action dialog"]
end

node_user(("Device user"))
node_system["Android system settings"]

node_user -->|"opens app"| node_main_activity
node_main_activity -->|"initializes"| node_settings_viewmodel
node_main_activity -->|"renders"| node_settings_ui
node_settings_viewmodel -->|"reads and writes"| node_preferences
node_preferences -->|"persists"| node_dns_entries
node_preferences -->|"persists"| node_wifi_rules
node_preferences -->|"exports settings"| node_backup
node_backup_parser -->|"parses"| node_backup
node_settings_viewmodel -.->|"restores backup"| node_backup_parser
node_settings_ui -->|"shows guidance"| node_permission_help
node_permission_help -.->|"checks grants"| node_permission_utils
node_settings_viewmodel -->|"checks permissions"| node_permission_utils
node_user -->|"toggles tile"| node_dns_tile
node_dns_tile -->|"loads configuration"| node_preferences
node_dns_tile -->|"selects next state"| node_dns_cycle
node_dns_tile -->|"changes Private DNS"| node_system
node_user -->|"toggles tile"| node_usb_tile
node_usb_tile -->|"loads configuration"| node_preferences
node_usb_tile -->|"changes debugging state"| node_system
node_dns_tile -.->|"reverts DNS"| node_revert
node_usb_tile -.->|"reverts USB state"| node_revert
node_settings_viewmodel -->|"starts monitoring"| node_network_service
node_settings_viewmodel -->|"starts monitoring"| node_vpn_service
node_network_service -->|"registers callbacks"| node_network_detection
node_vpn_service -->|"registers callbacks"| node_vpn_detection
node_network_service -.->|"applies network policy"| node_dns_automation
node_vpn_service -.->|"applies VPN policy"| node_dns_automation
node_dns_tile -->|"checks VPN state"| node_vpn_detection
node_user -->|"invokes shortcut"| node_shortcuts
node_shortcuts -.->|"dispatches DNS action"| node_dns_tile
node_shortcuts -.->|"dispatches USB action"| node_usb_tile
node_user -->|"opens quick action"| node_quick_actions
node_quick_actions -->|"invokes DNS action"| node_dns_tile
node_quick_actions -->|"invokes USB action"| node_usb_tile

click node_main_activity "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/MainActivity.kt"
click node_settings_ui "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/ui/composables/main/MainScreen.kt"
click node_settings_viewmodel "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/viewmodel/MainViewModel.kt"
click node_preferences "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/data/PreferencesManager.kt"
click node_dns_entries "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/data/DnsHostnameEntry.kt"
click node_wifi_rules "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/data/WifiDnsRule.kt"
click node_backup "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/data/SettingsBackup.kt"
click node_backup_parser "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/data/SettingsBackupJsonParser.kt"
click node_permission_help "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/ui/composables/permission/PermissionGrantDialog.kt"
click node_permission_utils "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/utils/PermissionUtils.kt"
click node_dns_tile "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/services/PrivateDnsTileService.kt"
click node_dns_cycle "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/services/DnsCyclePolicy.kt"
click node_usb_tile "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/services/UsbDebuggingTileService.kt"
click node_revert "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/utils/AutoRevertCoordinator.kt"
click node_network_service "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/services/NetworkMonitoringService.kt"
click node_vpn_service "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/services/VpnMonitoringService.kt"
click node_network_detection "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/utils/NetworkTypeDetectionUtils.kt"
click node_vpn_detection "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/utils/VpnDetectionUtils.kt"
click node_dns_automation "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/utils/NetworkDnsAutomation.kt"
click node_shortcuts "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/ShortcutActionActivity.kt"
click node_quick_actions "https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/QuickActionDialogActivity.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_preferences,node_dns_entries,node_wifi_rules,node_backup,node_backup_parser,node_user toneBlue
class node_dns_tile,node_dns_cycle toneAmber
class node_usb_tile,node_revert toneMint
class node_network_service,node_vpn_service,node_network_detection,node_vpn_detection,node_dns_automation toneRose
class node_main_activity,node_settings_ui,node_settings_viewmodel,node_permission_help,node_permission_utils,node_shortcuts,node_quick_actions,node_system toneIndigo
```

## Components

### Settings and data

- [Preferences](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/data/PreferencesManager.kt): `app/src/main/java/com/rbn/qtsettings/data/PreferencesManager.kt`
- [DNS entries](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/data/DnsHostnameEntry.kt): `app/src/main/java/com/rbn/qtsettings/data/DnsHostnameEntry.kt`
- [Wi-Fi DNS rules](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/data/WifiDnsRule.kt): `app/src/main/java/com/rbn/qtsettings/data/WifiDnsRule.kt`
- [Settings backup](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/data/SettingsBackup.kt): `app/src/main/java/com/rbn/qtsettings/data/SettingsBackup.kt`
- [Backup parser](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/data/SettingsBackupJsonParser.kt): `app/src/main/java/com/rbn/qtsettings/data/SettingsBackupJsonParser.kt`

### DNS controls

- [Private DNS tile](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/services/PrivateDnsTileService.kt): `app/src/main/java/com/rbn/qtsettings/services/PrivateDnsTileService.kt`
- [DNS cycle policy](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/services/DnsCyclePolicy.kt): `app/src/main/java/com/rbn/qtsettings/services/DnsCyclePolicy.kt`

### USB controls

- [USB debugging tile](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/services/UsbDebuggingTileService.kt): `app/src/main/java/com/rbn/qtsettings/services/UsbDebuggingTileService.kt`
- [Auto-revert](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/utils/AutoRevertCoordinator.kt): `app/src/main/java/com/rbn/qtsettings/utils/AutoRevertCoordinator.kt`

### Network automation

- [Network monitor](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/services/NetworkMonitoringService.kt): `app/src/main/java/com/rbn/qtsettings/services/NetworkMonitoringService.kt`
- [VPN monitor](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/services/VpnMonitoringService.kt): `app/src/main/java/com/rbn/qtsettings/services/VpnMonitoringService.kt`
- [Network detection](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/utils/NetworkTypeDetectionUtils.kt): `app/src/main/java/com/rbn/qtsettings/utils/NetworkTypeDetectionUtils.kt`
- [VPN detection](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/utils/VpnDetectionUtils.kt): `app/src/main/java/com/rbn/qtsettings/utils/VpnDetectionUtils.kt`
- [DNS automation](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/utils/NetworkDnsAutomation.kt): `app/src/main/java/com/rbn/qtsettings/utils/NetworkDnsAutomation.kt`

### App experience

- [Main activity](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/MainActivity.kt): `app/src/main/java/com/rbn/qtsettings/MainActivity.kt`
- [Settings UI](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/ui/composables/main/MainScreen.kt): `app/src/main/java/com/rbn/qtsettings/ui/composables/main/MainScreen.kt`
- [Settings model](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/viewmodel/MainViewModel.kt): `app/src/main/java/com/rbn/qtsettings/viewmodel/MainViewModel.kt`
- [Permission guidance](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/ui/composables/permission/PermissionGrantDialog.kt): `app/src/main/java/com/rbn/qtsettings/ui/composables/permission/PermissionGrantDialog.kt`
- [Permission checks](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/utils/PermissionUtils.kt): `app/src/main/java/com/rbn/qtsettings/utils/PermissionUtils.kt`
- [Shortcut actions](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/ShortcutActionActivity.kt): `app/src/main/java/com/rbn/qtsettings/ShortcutActionActivity.kt`
- [Quick action dialog](https://github.com/rbn-apps/quick-tile-settings/blob/main/app/src/main/java/com/rbn/qtsettings/QuickActionDialogActivity.kt): `app/src/main/java/com/rbn/qtsettings/QuickActionDialogActivity.kt`

### Other components

- **Device user**
- **Android system settings**

## Connections

- Device user → Main activity: opens app
- Main activity → Settings model: initializes (evidence: `app/src/main/java/com/rbn/qtsettings/MainActivity.kt`)
- Main activity → Settings UI: renders (evidence: `app/src/main/java/com/rbn/qtsettings/MainActivity.kt`)
- Settings model → Preferences: reads and writes (evidence: `app/src/main/java/com/rbn/qtsettings/viewmodel/MainViewModel.kt`)
- Preferences → DNS entries: persists (evidence: `app/src/main/java/com/rbn/qtsettings/data/PreferencesManager.kt`)
- Preferences → Wi-Fi DNS rules: persists (evidence: `app/src/main/java/com/rbn/qtsettings/data/PreferencesManager.kt`)
- Preferences → Settings backup: exports settings (evidence: `app/src/main/java/com/rbn/qtsettings/data/PreferencesManager.kt`)
- Backup parser → Settings backup: parses (evidence: `app/src/main/java/com/rbn/qtsettings/data/SettingsBackupJsonParser.kt`)
- Settings model → Backup parser: restores backup
- Settings UI → Permission guidance: shows guidance (evidence: `app/src/main/java/com/rbn/qtsettings/ui/composables/main/MainScreen.kt`)
- Permission guidance → Permission checks: checks grants
- Settings model → Permission checks: checks permissions (evidence: `app/src/main/java/com/rbn/qtsettings/viewmodel/MainViewModel.kt`)
- Device user → Private DNS tile: toggles tile
- Private DNS tile → Preferences: loads configuration (evidence: `app/src/main/java/com/rbn/qtsettings/services/PrivateDnsTileService.kt`)
- Private DNS tile → DNS cycle policy: selects next state (evidence: `app/src/main/java/com/rbn/qtsettings/services/PrivateDnsTileService.kt`)
- Private DNS tile → Android system settings: changes Private DNS
- Device user → USB debugging tile: toggles tile
- USB debugging tile → Preferences: loads configuration (evidence: `app/src/main/java/com/rbn/qtsettings/services/UsbDebuggingTileService.kt`)
- USB debugging tile → Android system settings: changes debugging state (evidence: `app/src/main/java/com/rbn/qtsettings/services/UsbDebuggingTileService.kt`)
- Private DNS tile → Auto-revert: reverts DNS (evidence: `app/src/main/java/com/rbn/qtsettings/services/PrivateDnsTileService.kt`)
- USB debugging tile → Auto-revert: reverts USB state (evidence: `app/src/main/java/com/rbn/qtsettings/services/UsbDebuggingTileService.kt`)
- Settings model → Network monitor: starts monitoring (evidence: `app/src/main/java/com/rbn/qtsettings/viewmodel/MainViewModel.kt`)
- Settings model → VPN monitor: starts monitoring (evidence: `app/src/main/java/com/rbn/qtsettings/viewmodel/MainViewModel.kt`)
- Network monitor → Network detection: registers callbacks (evidence: `app/src/main/java/com/rbn/qtsettings/services/NetworkMonitoringService.kt`)
- VPN monitor → VPN detection: registers callbacks (evidence: `app/src/main/java/com/rbn/qtsettings/services/VpnMonitoringService.kt`)
- Network monitor → DNS automation: applies network policy (evidence: `app/src/main/java/com/rbn/qtsettings/services/NetworkMonitoringService.kt`)
- VPN monitor → DNS automation: applies VPN policy (evidence: `app/src/main/java/com/rbn/qtsettings/services/VpnMonitoringService.kt`)
- Private DNS tile → VPN detection: checks VPN state (evidence: `app/src/main/java/com/rbn/qtsettings/services/PrivateDnsTileService.kt`)
- Device user → Shortcut actions: invokes shortcut
- Shortcut actions → Private DNS tile: dispatches DNS action
- Shortcut actions → USB debugging tile: dispatches USB action
- Device user → Quick action dialog: opens quick action (evidence: `app/src/main/java/com/rbn/qtsettings/QuickActionDialogActivity.kt`)
- Quick action dialog → Private DNS tile: invokes DNS action (evidence: `app/src/main/java/com/rbn/qtsettings/QuickActionDialogActivity.kt`)
- Quick action dialog → USB debugging tile: invokes USB action (evidence: `app/src/main/java/com/rbn/qtsettings/QuickActionDialogActivity.kt`)
