First Aid Manual–Offline Guide

Emergency medical guidance & AI assistant for critical situations

Comment

First Aid Manual – Offline Guide First Aid Manual – Offline Guide is a comprehensive mobile application designed to provide fast, reliable, and easy-to-understand first aid guidance in emergency situations. The app delivers detailed first aid instructions combined with an intelligent AI assistant to support users when every second matters. Inspiration The idea behind First Aid Manual – Offline Guide was born from a simple yet critical realization: Medical emergencies can happen anytime, anywhere — at home, at work, or on the street. However, most people lack sufficient first aid knowledge to respond effectively in urgent situations. In Vietnam and many developing regions, access to quick, accurate first aid information is especially crucial, where timely action can make the difference between life and death. Our goal was to create a tool that empowers everyone — regardless of age or medical background — to access clear, step-by-step first aid instructions with visual guidance and AI-powered support. By reducing reaction time during emergencies, we aim to potentially save lives. What It Does First Aid Manual – Offline Guide is a full-featured mobile application that provides: Detailed First Aid Instructions A curated database of 17+ common emergency scenarios, including: CPR Burns Bleeding Chemical exposure Drowning Electric shock And more AI-Powered Medical Assistant Integrated with Gemini (gemini-2.0-flash-lite) to deliver real-time guidance and contextual assistance during emergencies. Fast & Optimized Search Quickly find the right first aid instructions within seconds, even under stress. Emergency Map Integrated with VietMap to locate nearby hospitals and emergency centers. Emergency Contacts One-tap access to critical emergency phone numbers. Intuitive User Interface Designed for clarity and ease of use, even in high-pressure situations. Multi-language Support Available in Vietnamese, English, and Chinese, serving a diverse user base. How We Built It We adopted Clean Architecture, ensuring scalability, maintainability, and testability throughout the codebase. Layered Architecture Presentation Layer Built with Flutter widgets and managed using the BLoC pattern for predictable state management. Domain Layer Contains core business logic and entities, fully independent of frameworks. Data Layer Handles data sources from: Firebase Firestore Cloud Storage Third-party APIs Technology Stack Flutter 3.5.4 – Cross-platform UI framework Dart 3.5.4 – Programming language Firebase – Authentication, database, storage, and AI services (Vertex AI) BLoC – State management GetIt – Dependency injection GoRouter – Declarative navigation VietMap – Local map and location services Development Workflow UI/UX design following Material Design 3 Model and repository implementation Business logic development in the domain layer Feature and screen development in the presentation layer Firebase and external API integration Testing, performance tuning, and optimization Challenges We Faced VietMap Integration on Flutter Limited documentation required deep dives into native Swift and Kotlin code to customize functionality. Complex State Management Managing AI chat, maps, and real-time location updates across multiple screens required careful BLoC structuring. Performance Optimization Ensuring smooth performance on older devices (Android API 21+) involved: Image optimization Lazy loading Minimizing unnecessary widget rebuilds Firebase Multi-Flavor Configuration Handling dev, staging, and production environments — especially iOS GoogleService-Info.plist — introduced multiple edge cases. Data Accuracy & Reliability Maintaining accurate and up-to-date medical information required close collaboration with medical references and experts. Offline Functionality Implementing effective caching and local storage strategies to ensure access to critical instructions without internet connectivity. Achievements We’re Proud Of Production-Ready Application Fully built and ready for deployment on Google Play and App Store. Comprehensive Emergency Coverage 17+ emergency scenarios with detailed instructions, illustrations, and media support. Multi-language Support Seamlessly supports Vietnamese, English, and Chinese. Successful VietMap Custom Integration Customized mapping features to locate nearby medical facilities accurately. Clean Architecture Codebase Well-structured, maintainable, and easily extensible for future features. Complete Firebase Setup Firestore, Cloud Storage, and Vertex AI fully integrated. True Cross-Platform Experience Smooth, near-native performance on both iOS and Android.

Built With

Share this project:

Updates