🛡️ GuardianTrack — Personal Safety Android Application

GuardianTrack is a native Android application developed with Kotlin for personal safety monitoring and incident management.

The application combines background monitoring, emergency contact management, offline-first synchronization and secure local data storage using modern Android development practices.

✨ Key Features

• 🛡️ Personal safety and incident monitoring
• 📱 Native Android application built with Kotlin
• 🚨 Fall monitoring using a Foreground Service
• 👥 Emergency contact management
• 💾 Local incident storage with Room
• 🔄 Offline-first data synchronization with WorkManager
• 🔋 Battery status monitoring
• 🔁 Automatic recovery and background task handling after device restart
• 🔐 Secure storage for sensitive application data
• 📄 Incident data export to CSV
• 🌐 Remote incident synchronization through REST API

🏗️ Architecture

GuardianTrack follows modern Android development practices with an MVVM architecture and dependency injection using Hilt.

The application uses a Single Activity architecture combined with the Android Navigation Component.

Core Android Components

• MVVM — Application architecture
• Hilt — Dependency injection
• Room — Local storage for incidents and emergency contacts
• DataStore — User preferences
• EncryptedSharedPreferences — Secure storage
• Foreground Service — Continuous fall monitoring
• BroadcastReceiver — BOOT_COMPLETED and BATTERY_LOW event handling
• WorkManager — Offline-first background synchronization
• ContentProvider — Secure emergency contact access
• MediaStore — CSV export to device documents

🛠️ Tech Stack

• Kotlin
• Android SDK
• MVVM
• Hilt
• Room
• Navigation Component
• DataStore
• EncryptedSharedPreferences
• WorkManager
• Foreground Services
• ContentProvider
• MediaStore
• REST API

🔄 Offline-First Synchronization

GuardianTrack uses WorkManager to manage background synchronization between locally stored incidents and the remote API.

This approach allows the application to continue operating when network connectivity is unavailable and synchronize data when connectivity becomes available.

🔐 Security

The application implements secure data management through:

• Encrypted storage for sensitive information
• Secure ContentProvider access
• Local configuration excluded from version control
• Environment-specific API configuration

⚠️ API keys and environment-specific configuration must never be committed to the repository.

📸 Screenshots