How hopzalot/bashirconnect-app works
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: MainActivity.kt Main screen · CaptivePortalService.kt Portal monitor · StatsStore.kt Stats store · MrBashirTileService.kt Quick Settings tile
Components 19
Connection runtime
- Portal monitor
app/src/main/java/com/mrbashir/android/CaptivePortalService.kt - Portal login client
app/src/main/java/com/mrbashir/android/PortalLoginClient.kt - Boot receiver
app/src/main/java/com/mrbashir/android/BootReceiver.kt - Quick Settings tile
app/src/main/java/com/mrbashir/android/MrBashirTileService.kt
State and storage
- Credential store
app/src/main/java/com/mrbashir/android/CredentialStore.kt - Stats store
app/src/main/java/com/mrbashir/android/StatsStore.kt - Live connection status
app/src/main/java/com/mrbashir/android/AppStatus.kt - Live app statistics
app/src/main/java/com/mrbashir/android/AppStats.kt
App experience
- Main screen
app/src/main/java/com/mrbashir/android/MainActivity.kt - Credential editor
app/src/main/java/com/mrbashir/android/CredentialsCard.kt - Service controls
app/src/main/java/com/mrbashir/android/ActionButtons.kt - Status hero
app/src/main/java/com/mrbashir/android/HeroCard.kt - Animated mascot
app/src/main/java/com/mrbashir/android/AnimatedMascot.kt - Activity log card
app/src/main/java/com/mrbashir/android/ActivityLogCard.kt - Stats dashboard
app/src/main/java/com/mrbashir/android/StatsDashboard.kt
Fundraising
- Fund Me Jar
app/src/main/java/com/mrbashir/android/TipJarScreen.kt
Other components
- User
- Wi-Fi network
- Fortinet portal
Connections 27
- User → Main screen: sets up
README.md - Main screen → Credential store: saves or edits
app/src/main/java/com/mrbashir/android/MainActivity.kt - Main screen → Portal monitor: starts or stops
app/src/main/java/com/mrbashir/android/MainActivity.kt - Portal monitor → Wi-Fi network: watches
app/src/main/java/com/mrbashir/android/CaptivePortalService.kt - Portal monitor → Credential store: loads credentials
app/src/main/java/com/mrbashir/android/CaptivePortalService.kt - Portal monitor → Portal login client: checks and logs in
app/src/main/java/com/mrbashir/android/CaptivePortalService.kt - Portal login client → Fortinet portal: authenticates
app/src/main/java/com/mrbashir/android/PortalLoginClient.kt - Portal monitor → Live connection status: updates
app/src/main/java/com/mrbashir/android/CaptivePortalService.kt - Portal monitor → Stats store: records runtime
app/src/main/java/com/mrbashir/android/CaptivePortalService.kt - Stats store → Live app statistics: publishes statistics
app/src/main/java/com/mrbashir/android/StatsStore.kt - Boot receiver → Portal monitor: resumes
app/src/main/java/com/mrbashir/android/BootReceiver.kt - Boot receiver → Credential store: checks credentials
app/src/main/java/com/mrbashir/android/BootReceiver.kt - Boot receiver → Stats store: reads service state
app/src/main/java/com/mrbashir/android/BootReceiver.kt - Quick Settings tile → Credential store: checks credentials
app/src/main/java/com/mrbashir/android/MrBashirTileService.kt - Quick Settings tile → Stats store: checks running state
app/src/main/java/com/mrbashir/android/MrBashirTileService.kt - Quick Settings tile → Portal monitor: toggles
app/src/main/java/com/mrbashir/android/MrBashirTileService.kt - Main screen → Credential editor: renders
app/src/main/java/com/mrbashir/android/MainActivity.kt - Main screen → Service controls: renders
app/src/main/java/com/mrbashir/android/MainActivity.kt - Main screen → Status hero: renders
app/src/main/java/com/mrbashir/android/MainActivity.kt - Status hero → Animated mascot: renders
app/src/main/java/com/mrbashir/android/HeroCard.kt - Main screen → Activity log card: renders
app/src/main/java/com/mrbashir/android/MainActivity.kt - Main screen → Stats dashboard: renders
app/src/main/java/com/mrbashir/android/MainActivity.kt - Main screen → Live connection status: observes
app/src/main/java/com/mrbashir/android/MainActivity.kt - Main screen → Stats store: reads statistics
app/src/main/java/com/mrbashir/android/MainActivity.kt - Main screen → Live app statistics: observes
app/src/main/java/com/mrbashir/android/MainActivity.kt - Main screen → Fund Me Jar: opens
app/src/main/java/com/mrbashir/android/MainActivity.kt - User → Quick Settings tile: toggles monitoring
app/src/main/java/com/mrbashir/android/MrBashirTileService.kt