How dvj1/safepath works
SafePath is a Flutter smart-stick companion and caregiver safety app. Users monitor stick and surface hazards with voice guidance, trigger or cancel fall alarms, and send GPS-backed SOS alerts; caregivers monitor telemetry, respond through an emergency lifecycle, and review history and user details. The README documents the Dart subsystem roles and capabilities, but sampled source excerpts cover only platform runners, not Dart runtime calls; edges below therefore represent documented relationships, not independently verified call sites.
Main entry points: emergency_service.dart Emergency Coordination · caregiver_dashboard_screen.dart Caregiver Dashboard · user_dashboard_screen.dart User Dashboard · main.dart Flutter App
Components 24
User Experience
- Flutter App
lib/main.dart - User Dashboard
lib/screens/user_dashboard_screen.dart - Live Map
lib/widgets/live_map_view.dart - Hardware Settings
lib/screens/hardware_settings_screen.dart
Safety Workflows
- SOS Control
lib/widgets/sos_emergency_button.dart - Fall Alarm
lib/services/emergency_service.dart - Emergency Coordination
lib/services/emergency_service.dart - Emergency Event
lib/models/emergency_event.dart
Device and App Services
- Stick Telemetry
lib/models/stick_sensor_data.dart - Stick Integration
lib/services/hardware_service.dart - Voice and Haptics
lib/services/tts_audio_service.dart - Phone Location
lib/services/location_service.dart - Backend Repository
lib/services/backend_service.dart - Emergency Notifications
lib/services/notification_service.dart - Local Storage
lib/services/storage_service.dart - ESP32 Configuration
lib/models/esp32_config.dart
Caregiver Response
- Caregiver Dashboard
lib/screens/caregiver_dashboard_screen.dart - Emergency History
lib/screens/emergency_history_screen.dart - Emergency Details
lib/screens/emergency_details_screen.dart - Contacts and Profile
lib/screens/contacts_screen.dart - User Profile
lib/models/user_profile.dart
Other components
- Stick User
- Caregiver
- ESP32 Stick
Connections 27
- Stick User → Flutter App: uses
README.md - Caregiver → Flutter App: uses
README.md - Flutter App → User Dashboard: presents
README.md - Flutter App → Caregiver Dashboard: presents
README.md - User Dashboard → Stick Telemetry: shows telemetry
README.md - Stick Integration → ESP32 Stick: reads sensors
README.md - Stick Integration → Stick Telemetry: produces readings
README.md - User Dashboard → Voice and Haptics: announces hazards
README.md - User Dashboard → SOS Control: offers SOS
README.md - Fall Alarm → Emergency Coordination: triggers after countdown
README.md - SOS Control → Emergency Coordination: triggers
README.md - Emergency Coordination → Phone Location: gets coordinates
README.md - Emergency Coordination → Backend Repository: broadcasts alert
README.md - Emergency Coordination → Emergency Notifications: sends notification
README.md - Emergency Coordination → Emergency Event: records event
README.md - Caregiver Dashboard → Stick Telemetry: shows telemetry
README.md - Caregiver Dashboard → Live Map: shows location
README.md - Live Map → Phone Location: displays position
README.md - Caregiver Dashboard → Emergency History: opens logs
README.md - Emergency History → Emergency Details: opens event
README.md - Emergency Details → Emergency Event: shows lifecycle
README.md - Caregiver Dashboard → Contacts and Profile: views user details
README.md - Contacts and Profile → User Profile: shows profile
README.md - Emergency History → Local Storage: reads past logs
README.md - Hardware Settings → ESP32 Configuration: edits configuration
README.md - Hardware Settings → Stick Integration: configures device
README.md - Backend Repository → Local Storage: uses local persistence