How shermr6/aircraft-tracker-desktop works
AircraftTracker is an Electron/React desktop client for activating a license and then managing monitored aircraft, airport settings, alerts, integrations, and live tracking. The principal workflow runs from activation through authenticated dashboard navigation to configuration and live status; screens make backend requests through a shared API client, while a background poller maintains live positions and trails. Local storage persists credentials and preferences through Electron when available. The README documents webhook integrations and tracking capabilities; unsampled implementation details are represented at subsystem level, and only documented or indexed relationships are shown.
Main entry points: Dashboard.jsx Dashboard navigation · api.js Backend API client · App.jsx App routing · ActivationScreen.jsx License activation
Components 23
Desktop application
- App routing
src/App.jsx - Dashboard navigation
src/screens/Dashboard.jsx - Secure IPC bridge
src/main/preload.js - Electron lifecycle
src/main/main.js - Backend API client
src/services/api.js
Account and preferences
- License activation
src/screens/ActivationScreen.jsx - Persistent preferences
src/services/storage.js - Plan limits
src/config/tierLimits.js
Tracking configuration
- Aircraft management
src/screens/AircraftManager.jsx - Airport configuration
src/screens/AirportConfig.jsx - Saved locations
src/screens/SavedLocations.jsx - Alert settings
src/screens/AlertSettings.jsx - Webhook integrations
src/screens/Integrations.jsx - Team collaboration
src/screens/Teams.jsx
Live operations
- Status overview
src/screens/DashboardHome.jsx - Live aircraft map
src/screens/LiveMap.jsx - Position poller
src/services/backgroundTracker.js - Tracking logs
src/screens/Logs.jsx - Ground station setup
src/screens/GroundStationSetup.jsx - Tracker process bridge
src/main/tracker_bridge.js - Discord bot
tracker/aviation_tracker_discord_bot.py
Other components
- User
- AircraftTracker backend
Connections 34
- User → App routing: uses
README.md - App routing → License activation: routes to
src/App.jsx - App routing → Dashboard navigation: routes to
src/App.jsx - License activation → Backend API client: authenticates with
src/screens/ActivationScreen.jsx - License activation → Persistent preferences: persists credentials
src/screens/ActivationScreen.jsx - Dashboard navigation → Persistent preferences: reads and writes
src/screens/Dashboard.jsx - Persistent preferences → Secure IPC bridge: uses IPC
src/services/storage.js - Electron lifecycle → Secure IPC bridge: configures
README.md - Electron lifecycle → Tracker process bridge: starts
src/main/main.js - Backend API client → AircraftTracker backend: sends requests
src/services/api.js - Dashboard navigation → Aircraft management: navigates to
src/screens/Dashboard.jsx - Dashboard navigation → Airport configuration: navigates to
src/screens/Dashboard.jsx - Dashboard navigation → Alert settings: navigates to
src/screens/Dashboard.jsx - Dashboard navigation → Webhook integrations: navigates to
src/screens/Dashboard.jsx - Dashboard navigation → Status overview: navigates to
src/screens/Dashboard.jsx - Dashboard navigation → Live aircraft map: navigates to
src/screens/Dashboard.jsx - Dashboard navigation → Tracking logs: navigates to
src/screens/Dashboard.jsx - Dashboard navigation → Ground station setup: navigates to
src/screens/Dashboard.jsx - Dashboard navigation → Saved locations: navigates to
- Dashboard navigation → Team collaboration: navigates to
- Aircraft management → Backend API client: manages aircraft via
src/screens/AircraftManager.jsx - Aircraft management → Plan limits: checks plan limits
src/screens/AircraftManager.jsx - Airport configuration → Backend API client: configures airport via
src/screens/AirportConfig.jsx - Saved locations → Backend API client: loads and saves via
src/screens/SavedLocations.jsx - Alert settings → Backend API client: configures alerts via
src/screens/AlertSettings.jsx - Alert settings → Plan limits: checks plan limits
src/screens/AlertSettings.jsx - Webhook integrations → Backend API client: manages webhooks via
src/screens/Integrations.jsx - Webhook integrations → Plan limits: checks plan limits
src/screens/Integrations.jsx - Status overview → Backend API client: loads status via
src/screens/DashboardHome.jsx - Live aircraft map → Position poller: reads positions
src/services/backgroundTracker.js - Position poller → Backend API client: polls live aircraft
src/services/backgroundTracker.js - Tracking logs → Backend API client: loads tracking logs
src/screens/Logs.jsx - Ground station setup → Backend API client: loads station status
src/screens/GroundStationSetup.jsx - Discord bot → AircraftTracker backend: integrates with