# hopzalot/bashirconnect-app architecture

> Architecture diagram of the GitHub repository hopzalot/bashirconnect-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/hopzalot/bashirconnect-app
- Repository: https://github.com/hopzalot/bashirconnect-app

## Overview

BashirConnect is an Android assistant for automatically signing in to NUST CEME’s Fortinet captive portal. The principal workflow is: a user saves credentials and starts monitoring; the foreground service watches Wi-Fi, checks for portal interception, and asks the login client to authenticate; status and activity are then surfaced in the app. The graph also preserves credential editing, reboot/tile controls, usage statistics, and the optional Fund Me Jar. Relationships are based on the README and shown source/index references; unsampled implementation details are not expanded.

Main entry points: [`app/src/main/java/com/mrbashir/android/MainActivity.kt`](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/MainActivity.kt) (Main screen), [`app/src/main/java/com/mrbashir/android/CaptivePortalService.kt`](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/CaptivePortalService.kt) (Portal monitor), [`app/src/main/java/com/mrbashir/android/StatsStore.kt`](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/StatsStore.kt) (Stats store), [`app/src/main/java/com/mrbashir/android/MrBashirTileService.kt`](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/MrBashirTileService.kt) (Quick Settings tile)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Connection runtime"]
  node_service["Portal monitor"]
  node_login["Portal login client"]
  node_boot["Boot receiver<br/>[BootReceiver.kt]"]
  node_tile["Quick Settings tile"]
end

subgraph group_state["State and storage"]
  node_credentials[("Credential store<br/>[CredentialStore.kt]")]
  node_statsstore[("Stats store<br/>[StatsStore.kt]")]
  node_status["Live connection status<br/>[AppStatus.kt]"]
  node_stats["Live app statistics<br/>[AppStats.kt]"]
end

subgraph group_ui["App experience"]
  node_activity["Main screen<br/>[MainActivity.kt]"]
  node_credentialsui["Credential editor<br/>[CredentialsCard.kt]"]
  node_actions["Service controls<br/>[ActionButtons.kt]"]
  node_hero["Status hero<br/>[HeroCard.kt]"]
  node_mascot["Animated mascot<br/>[AnimatedMascot.kt]"]
  node_activitylog["Activity log card<br/>[ActivityLogCard.kt]"]
  node_dashboard["Stats dashboard<br/>[StatsDashboard.kt]"]
end

subgraph group_fundraising["Fundraising"]
  node_tipjar["Fund Me Jar<br/>[TipJarScreen.kt]"]
end

node_user(("User"))
node_wifi{{"Wi-Fi network"}}
node_portal{{"Fortinet portal"}}

node_user -->|"sets up"| node_activity
node_activity -->|"saves or edits"| node_credentials
node_activity -->|"starts or stops"| node_service
node_service -->|"watches"| node_wifi
node_service -->|"loads credentials"| node_credentials
node_service -->|"checks and logs in"| node_login
node_login -->|"authenticates"| node_portal
node_service -->|"updates"| node_status
node_service -->|"records runtime"| node_statsstore
node_statsstore -->|"publishes statistics"| node_stats
node_boot -->|"resumes"| node_service
node_boot -->|"checks credentials"| node_credentials
node_boot -->|"reads service state"| node_statsstore
node_tile -->|"checks credentials"| node_credentials
node_tile -->|"checks running state"| node_statsstore
node_tile -->|"toggles"| node_service
node_activity -->|"renders"| node_credentialsui
node_activity -->|"renders"| node_actions
node_activity -->|"renders"| node_hero
node_hero -->|"renders"| node_mascot
node_activity -->|"renders"| node_activitylog
node_activity -->|"renders"| node_dashboard
node_activity -->|"observes"| node_status
node_activity -->|"reads statistics"| node_statsstore
node_activity -->|"observes"| node_stats
node_activity -->|"opens"| node_tipjar
node_user -->|"toggles monitoring"| node_tile

click node_service "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/CaptivePortalService.kt"
click node_login "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/PortalLoginClient.kt"
click node_boot "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/BootReceiver.kt"
click node_tile "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/MrBashirTileService.kt"
click node_credentials "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/CredentialStore.kt"
click node_statsstore "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/StatsStore.kt"
click node_status "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/AppStatus.kt"
click node_stats "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/AppStats.kt"
click node_activity "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/MainActivity.kt"
click node_credentialsui "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/CredentialsCard.kt"
click node_actions "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/ActionButtons.kt"
click node_hero "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/HeroCard.kt"
click node_mascot "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/AnimatedMascot.kt"
click node_activitylog "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/ActivityLogCard.kt"
click node_dashboard "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/StatsDashboard.kt"
click node_tipjar "https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/TipJarScreen.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_service,node_login,node_boot,node_tile,node_user toneBlue
class node_credentials,node_statsstore,node_status,node_stats toneAmber
class node_activity,node_credentialsui,node_actions,node_hero,node_mascot,node_activitylog,node_dashboard toneMint
class node_tipjar toneRose
class node_wifi,node_portal toneIndigo
```

## Components

### Connection runtime

- [Portal monitor](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/CaptivePortalService.kt): `app/src/main/java/com/mrbashir/android/CaptivePortalService.kt`
- [Portal login client](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/PortalLoginClient.kt): `app/src/main/java/com/mrbashir/android/PortalLoginClient.kt`
- [Boot receiver](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/BootReceiver.kt): `app/src/main/java/com/mrbashir/android/BootReceiver.kt`
- [Quick Settings tile](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/MrBashirTileService.kt): `app/src/main/java/com/mrbashir/android/MrBashirTileService.kt`

### State and storage

- [Credential store](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/CredentialStore.kt): `app/src/main/java/com/mrbashir/android/CredentialStore.kt`
- [Stats store](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/StatsStore.kt): `app/src/main/java/com/mrbashir/android/StatsStore.kt`
- [Live connection status](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/AppStatus.kt): `app/src/main/java/com/mrbashir/android/AppStatus.kt`
- [Live app statistics](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/AppStats.kt): `app/src/main/java/com/mrbashir/android/AppStats.kt`

### App experience

- [Main screen](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/MainActivity.kt): `app/src/main/java/com/mrbashir/android/MainActivity.kt`
- [Credential editor](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/CredentialsCard.kt): `app/src/main/java/com/mrbashir/android/CredentialsCard.kt`
- [Service controls](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/ActionButtons.kt): `app/src/main/java/com/mrbashir/android/ActionButtons.kt`
- [Status hero](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/HeroCard.kt): `app/src/main/java/com/mrbashir/android/HeroCard.kt`
- [Animated mascot](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/AnimatedMascot.kt): `app/src/main/java/com/mrbashir/android/AnimatedMascot.kt`
- [Activity log card](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/ActivityLogCard.kt): `app/src/main/java/com/mrbashir/android/ActivityLogCard.kt`
- [Stats dashboard](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/StatsDashboard.kt): `app/src/main/java/com/mrbashir/android/StatsDashboard.kt`

### Fundraising

- [Fund Me Jar](https://github.com/hopzalot/bashirconnect-app/blob/main/app/src/main/java/com/mrbashir/android/TipJarScreen.kt): `app/src/main/java/com/mrbashir/android/TipJarScreen.kt`

### Other components

- **User**
- **Wi-Fi network**
- **Fortinet portal**

## Connections

- User → Main screen: sets up (evidence: `README.md`)
- Main screen → Credential store: saves or edits (evidence: `app/src/main/java/com/mrbashir/android/MainActivity.kt`)
- Main screen → Portal monitor: starts or stops (evidence: `app/src/main/java/com/mrbashir/android/MainActivity.kt`)
- Portal monitor → Wi-Fi network: watches (evidence: `app/src/main/java/com/mrbashir/android/CaptivePortalService.kt`)
- Portal monitor → Credential store: loads credentials (evidence: `app/src/main/java/com/mrbashir/android/CaptivePortalService.kt`)
- Portal monitor → Portal login client: checks and logs in (evidence: `app/src/main/java/com/mrbashir/android/CaptivePortalService.kt`)
- Portal login client → Fortinet portal: authenticates (evidence: `app/src/main/java/com/mrbashir/android/PortalLoginClient.kt`)
- Portal monitor → Live connection status: updates (evidence: `app/src/main/java/com/mrbashir/android/CaptivePortalService.kt`)
- Portal monitor → Stats store: records runtime (evidence: `app/src/main/java/com/mrbashir/android/CaptivePortalService.kt`)
- Stats store → Live app statistics: publishes statistics (evidence: `app/src/main/java/com/mrbashir/android/StatsStore.kt`)
- Boot receiver → Portal monitor: resumes (evidence: `app/src/main/java/com/mrbashir/android/BootReceiver.kt`)
- Boot receiver → Credential store: checks credentials (evidence: `app/src/main/java/com/mrbashir/android/BootReceiver.kt`)
- Boot receiver → Stats store: reads service state (evidence: `app/src/main/java/com/mrbashir/android/BootReceiver.kt`)
- Quick Settings tile → Credential store: checks credentials (evidence: `app/src/main/java/com/mrbashir/android/MrBashirTileService.kt`)
- Quick Settings tile → Stats store: checks running state (evidence: `app/src/main/java/com/mrbashir/android/MrBashirTileService.kt`)
- Quick Settings tile → Portal monitor: toggles (evidence: `app/src/main/java/com/mrbashir/android/MrBashirTileService.kt`)
- Main screen → Credential editor: renders (evidence: `app/src/main/java/com/mrbashir/android/MainActivity.kt`)
- Main screen → Service controls: renders (evidence: `app/src/main/java/com/mrbashir/android/MainActivity.kt`)
- Main screen → Status hero: renders (evidence: `app/src/main/java/com/mrbashir/android/MainActivity.kt`)
- Status hero → Animated mascot: renders (evidence: `app/src/main/java/com/mrbashir/android/HeroCard.kt`)
- Main screen → Activity log card: renders (evidence: `app/src/main/java/com/mrbashir/android/MainActivity.kt`)
- Main screen → Stats dashboard: renders (evidence: `app/src/main/java/com/mrbashir/android/MainActivity.kt`)
- Main screen → Live connection status: observes (evidence: `app/src/main/java/com/mrbashir/android/MainActivity.kt`)
- Main screen → Stats store: reads statistics (evidence: `app/src/main/java/com/mrbashir/android/MainActivity.kt`)
- Main screen → Live app statistics: observes (evidence: `app/src/main/java/com/mrbashir/android/MainActivity.kt`)
- Main screen → Fund Me Jar: opens (evidence: `app/src/main/java/com/mrbashir/android/MainActivity.kt`)
- User → Quick Settings tile: toggles monitoring (evidence: `app/src/main/java/com/mrbashir/android/MrBashirTileService.kt`)
