# yjeanrenaud/yj_nearbyglasses architecture

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

- Interactive diagram: https://gitdiagram.com/yjeanrenaud/yj_nearbyglasses
- Repository: https://github.com/yjeanrenaud/yj_nearbyglasses

## Overview

Nearby Glasses is a cross-platform mobile app that scans nearby Bluetooth LE advertisements for smart-glasses-related manufacturer IDs, names, and service signals, then warns the user and records detections locally. Android uses a foreground scan service and notifications; iOS uses a scanner store and in-app canary/log UI. Settings cover scan thresholds, cooldown, debug behavior, and language. The duplicate Android source trees are represented by the app module paths. Relationships for unsampled features rely on README claims or SOURCE INDEX references; uncertain wiring is omitted.

Main entry points: [`iOS/NearbyGlasses/ContentView.swift`](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/ContentView.swift) (Main screen), [`iOS/NearbyGlasses/ScannerStore.swift`](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/ScannerStore.swift) (Scanner store), [`iOS/NearbyGlasses/LanguageManager.swift`](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/LanguageManager.swift) (Language manager), [`Android/app/src/main/java/ch/pocketpc/nearbyglasses/BluetoothScanService.kt`](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/BluetoothScanService.kt) (Scan service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android app"]
  node_android_ui["Main screen<br/>[MainActivity.kt]"]
  node_android_service["Scan service"]
  node_android_scanner["BLE scanner"]
  node_android_notify["Alerts"]
  node_android_settings["Settings screen"]
end

subgraph group_ios["iOS app"]
  node_ios_app["App entry"]
  node_ios_view["Main screen<br/>[ContentView.swift]"]
  node_ios_store["Scanner store<br/>[ScannerStore.swift]"]
  node_ios_scanner["BLE scanner<br/>[BLEScanner.swift]"]
  node_ios_log["Detection log<br/>[LogEntry.swift]"]
  node_ios_settings["Settings view<br/>[SettingsView.swift]"]
  node_ios_canary["Canary panel<br/>[CanaryPanel.swift]"]
  node_ios_warning["Warning card<br/>[WarningCard.swift]"]
  node_ios_share["Share sheet<br/>[ShareSheet.swift]"]
end

subgraph group_domain["Detection domain"]
  node_android_event["Detection event<br/>[DetectionEvent.kt]"]
  node_ios_event["Detection event"]
end

subgraph group_settings["Settings and language"]
  node_android_prefs[("Preferences")]
  node_ios_config[("App settings<br/>[AppSettings.swift]")]
  node_ios_language["Language manager"]
  node_ios_catalog["Localization catalog"]
end

node_user(("User"))

node_user -->|"uses"| node_android_ui
node_android_service -->|"starts scan"| node_android_scanner
node_android_scanner -->|"classifies"| node_android_event
node_android_service -.->|"sends alerts"| node_android_notify
node_android_service -->|"reads settings"| node_android_prefs
node_android_ui -->|"reads settings"| node_android_prefs
node_android_notify -->|"formats alert"| node_android_event
node_android_settings -.->|"updates settings"| node_android_prefs
node_user -->|"uses"| node_ios_view
node_ios_app -->|"shows"| node_ios_view
node_ios_view -->|"controls scan"| node_ios_store
node_ios_store -->|"configures scanner"| node_ios_scanner
node_ios_scanner -->|"emits detections"| node_ios_event
node_ios_store -->|"handles detections"| node_ios_event
node_ios_store -->|"appends entries"| node_ios_log
node_ios_view -->|"renders"| node_ios_canary
node_ios_view -->|"renders"| node_ios_warning
node_ios_view -->|"presents export"| node_ios_share
node_ios_view -->|"shows settings"| node_ios_settings
node_ios_view -->|"reads settings"| node_ios_config
node_ios_settings -->|"edits settings"| node_ios_config
node_ios_store -->|"reads configuration"| node_ios_config
node_ios_store -->|"uses translations"| node_ios_language
node_ios_scanner -->|"formats status"| node_ios_language
node_ios_language -->|"loads strings"| node_ios_catalog
node_ios_view -->|"renders text"| node_ios_language

click node_android_ui "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/MainActivity.kt"
click node_android_service "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/BluetoothScanService.kt"
click node_android_scanner "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/scanner/BluetoothScanner.kt"
click node_android_event "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/model/DetectionEvent.kt"
click node_android_notify "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/util/NotificationHelper.kt"
click node_android_prefs "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/util/PreferencesManager.kt"
click node_android_settings "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/SettingsActivity.kt"
click node_ios_app "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/NearbyGlassesApp.swift"
click node_ios_view "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/ContentView.swift"
click node_ios_store "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/ScannerStore.swift"
click node_ios_scanner "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/BLEScanner.swift"
click node_ios_event "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/DetectionEvent.swift"
click node_ios_log "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/LogEntry.swift"
click node_ios_settings "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/SettingsView.swift"
click node_ios_config "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/AppSettings.swift"
click node_ios_language "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/LanguageManager.swift"
click node_ios_catalog "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/LocalizationCatalog.swift"
click node_ios_canary "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/CanaryPanel.swift"
click node_ios_warning "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/WarningCard.swift"
click node_ios_share "https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/ShareSheet.swift"

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_android_ui,node_android_service,node_android_scanner,node_android_notify,node_android_settings,node_user toneBlue
class node_ios_app,node_ios_view,node_ios_store,node_ios_scanner,node_ios_log,node_ios_settings,node_ios_canary,node_ios_warning,node_ios_share toneAmber
class node_android_event,node_ios_event toneMint
class node_android_prefs,node_ios_config,node_ios_language,node_ios_catalog toneRose
```

## Components

### Android app

- [Main screen](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/MainActivity.kt): `Android/app/src/main/java/ch/pocketpc/nearbyglasses/MainActivity.kt`
- [Scan service](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/BluetoothScanService.kt): `Android/app/src/main/java/ch/pocketpc/nearbyglasses/BluetoothScanService.kt`
- [BLE scanner](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/scanner/BluetoothScanner.kt): `Android/app/src/main/java/ch/pocketpc/nearbyglasses/scanner/BluetoothScanner.kt`
- [Alerts](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/util/NotificationHelper.kt): `Android/app/src/main/java/ch/pocketpc/nearbyglasses/util/NotificationHelper.kt`
- [Settings screen](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/SettingsActivity.kt): `Android/app/src/main/java/ch/pocketpc/nearbyglasses/SettingsActivity.kt`

### iOS app

- [App entry](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/NearbyGlassesApp.swift): `iOS/NearbyGlasses/NearbyGlassesApp.swift`
- [Main screen](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/ContentView.swift): `iOS/NearbyGlasses/ContentView.swift`
- [Scanner store](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/ScannerStore.swift): `iOS/NearbyGlasses/ScannerStore.swift`
- [BLE scanner](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/BLEScanner.swift): `iOS/NearbyGlasses/BLEScanner.swift`
- [Detection log](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/LogEntry.swift): `iOS/NearbyGlasses/LogEntry.swift`
- [Settings view](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/SettingsView.swift): `iOS/NearbyGlasses/SettingsView.swift`
- [Canary panel](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/CanaryPanel.swift): `iOS/NearbyGlasses/CanaryPanel.swift`
- [Warning card](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/WarningCard.swift): `iOS/NearbyGlasses/WarningCard.swift`
- [Share sheet](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/ShareSheet.swift): `iOS/NearbyGlasses/ShareSheet.swift`

### Detection domain

- [Detection event](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/model/DetectionEvent.kt): `Android/app/src/main/java/ch/pocketpc/nearbyglasses/model/DetectionEvent.kt`
- [Detection event](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/DetectionEvent.swift): `iOS/NearbyGlasses/DetectionEvent.swift`

### Settings and language

- [Preferences](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android/app/src/main/java/ch/pocketpc/nearbyglasses/util/PreferencesManager.kt): `Android/app/src/main/java/ch/pocketpc/nearbyglasses/util/PreferencesManager.kt`
- [App settings](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/AppSettings.swift): `iOS/NearbyGlasses/AppSettings.swift`
- [Language manager](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/LanguageManager.swift): `iOS/NearbyGlasses/LanguageManager.swift`
- [Localization catalog](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS/NearbyGlasses/LocalizationCatalog.swift): `iOS/NearbyGlasses/LocalizationCatalog.swift`

### Other components

- **User**

## Connections

- User → Main screen: uses (evidence: `README.md`)
- Scan service → BLE scanner: starts scan (evidence: `Android/app/src/main/java/ch/pocketpc/nearbyglasses/BluetoothScanService.kt`)
- BLE scanner → Detection event: classifies
- Scan service → Alerts: sends alerts (evidence: `Android/app/src/main/java/ch/pocketpc/nearbyglasses/BluetoothScanService.kt`)
- Scan service → Preferences: reads settings (evidence: `Android/app/src/main/java/ch/pocketpc/nearbyglasses/BluetoothScanService.kt`)
- Main screen → Preferences: reads settings
- Alerts → Detection event: formats alert
- Settings screen → Preferences: updates settings
- User → Main screen: uses (evidence: `README.md`)
- App entry → Main screen: shows (evidence: `iOS/NearbyGlasses/NearbyGlassesApp.swift`)
- Main screen → Scanner store: controls scan (evidence: `iOS/NearbyGlasses/ContentView.swift`)
- Scanner store → BLE scanner: configures scanner (evidence: `iOS/NearbyGlasses/ScannerStore.swift`)
- BLE scanner → Detection event: emits detections (evidence: `iOS/NearbyGlasses/BLEScanner.swift`)
- Scanner store → Detection event: handles detections (evidence: `iOS/NearbyGlasses/ScannerStore.swift`)
- Scanner store → Detection log: appends entries (evidence: `iOS/NearbyGlasses/ScannerStore.swift`)
- Main screen → Canary panel: renders (evidence: `iOS/NearbyGlasses/ContentView.swift`)
- Main screen → Warning card: renders (evidence: `iOS/NearbyGlasses/ContentView.swift`)
- Main screen → Share sheet: presents export (evidence: `iOS/NearbyGlasses/ContentView.swift`)
- Main screen → Settings view: shows settings (evidence: `iOS/NearbyGlasses/ContentView.swift`)
- Main screen → App settings: reads settings (evidence: `iOS/NearbyGlasses/ContentView.swift`)
- Settings view → App settings: edits settings (evidence: `iOS/NearbyGlasses/SettingsView.swift`)
- Scanner store → App settings: reads configuration (evidence: `iOS/NearbyGlasses/ScannerStore.swift`)
- Scanner store → Language manager: uses translations (evidence: `iOS/NearbyGlasses/ScannerStore.swift`)
- BLE scanner → Language manager: formats status (evidence: `iOS/NearbyGlasses/BLEScanner.swift`)
- Language manager → Localization catalog: loads strings (evidence: `iOS/NearbyGlasses/LanguageManager.swift`)
- Main screen → Language manager: renders text (evidence: `iOS/NearbyGlasses/ContentView.swift`)
