BeyondPeace is a comprehensive Flutter-based mental health and wellness application that combines AI-powered features, real-time services, and holistic wellness tools into a single platform. Developed as a Google Solution Challenge 2025 project by a team from A. G. Patil Institute of Technology, Solapur, the app aligns with UN Sustainable Development Goal 3: Good Health and Well-being.
Millions globally face mental health challenges, yet timely and effective support remains scarce due to stigma, lack of awareness, and limited resources. Existing solutions often miss integrated care — there is no single platform that combines AI-powered mental health assessment, crisis support, hospital locators, medical record management, relaxation tools, and professional consultation.
BeyondPeace bridges these gaps by offering an accessible, all-in-one mental health platform with AI-driven features, emergency support, and holistic wellness tools — empowering users with innovative technology to foster emotional resilience and better mental health outcomes.
- Dynamic Mental Health Assessment — Questions are freshly generated by Google Gemini 2.0 Flash AI on each session, covering mood, sleep, stress, relationships, and more. Falls back to curated static questions if offline. Tiered scoring (10–40 points) provides personalized feature recommendations.
- AI Mental Health Chatbot ("MindHelper") — Domain-restricted conversational AI that responds only to mental health topics. Uses prompt engineering to be empathetic, concise, and suggests professional help when needed.
- Email/password registration and login via Firebase Auth
- Google Sign-In integration
- Guest access mode
- User profile storage in Cloud Firestore
- Rich home screen with carousel slider, glass-morphism cards, and gradient UI
- Quick access to all features via tappable sections
- Floating Action Button for instant AI chat access
- One-tap emergency dialer accessible from the home screen
- Direct calling to Ambulance (102), Police (100), Fire (101), Women's Helpline (181), and personal emergency contacts
- Swipeable vertical card interface for quick selection
- 10-question assessment with 4 options each (scored 4/3/2/1)
- Score-based personalized recommendations:
- Excellent (>35) → Music therapy
- Good (25–35) → Music + Special Events
- Needs Improvement (15–25) → Music + Events + Brain Exercises
- Needs Support (10–15) → Music + Events + Exercises + Specialist Consultation
- Built-in audio player with 4 curated tracks: Brain Healing, Focus Music, Study Music, Meditation Music
- Full playback controls: play/pause, skip, progress bar
- Mini-player bar with expand/collapse animation
- Curated YouTube video library for mental exercises and brain training
- In-app YouTube player with autoplay
- Videos sourced from a local JSON data file
- Google Maps integration with hybrid satellite view
- GPS-based real-time location detection
- Google Places API for discovering nearby hospitals and medical facilities
- Custom markers and interactive map controls
- Directory of psychiatrists with profile cards
- Direct link to external chat-based consultation platform
- Glass-morphism card UI with doctor avatars
- Upload PDF medical reports from device storage
- Cloud storage via Firebase Storage
- In-app PDF viewer for saved reports
- Pull-to-refresh with liquid animation effect
- Curated list of wellness events (Stress Reduction, Laughter Club, Guided Meditation, Mindful Breathing, Yoga Classes)
- Event details with dates, times, and registration link
- Full Dockerized development environment with Flutter SDK + Android build tools
docker-compose.ymlfor one-command setup- Persistent pub cache volume for faster rebuilds
| Layer | Technology |
|---|---|
| Framework | Flutter 3.19.5 (Dart) |
| AI/ML | Google Gemini 2.0 Flash API |
| Authentication | Firebase Auth + Google Sign-In |
| Database | Cloud Firestore |
| File Storage | Firebase Storage |
| Maps | Google Maps Flutter + Google Places API |
| Location | Geolocator |
| Media | AudioPlayers, YouTube Player Flutter, Chewie |
| UI | Google Fonts, Carousel Slider, CurvedNavigationBar, Glass-morphism |
| Containerization | Docker + Docker Compose |
- Flutter SDK 3.19.x or later
- Android Studio with Android SDK 34
- Firebase project with Auth, Firestore, and Storage enabled
- Google Maps API key
- Gemini API key
-
Clone the repository:
git clone https://github.com/shoaib-inamdar/beyondpeaceapp.git cd beyondpeaceapp -
Configure API keys:
- Set Gemini API key in
lib/api.dart - Set Google Maps API key in
lib/pages/Maps/Maps.dart - Place
google-services.jsoninandroid/app/
- Set Gemini API key in
-
Install dependencies:
flutter pub get
-
Run the app:
flutter run
docker-compose up --build
docker-compose exec beyondpeace bash
flutter build apk --debug|
Splash Screen Animated splash with BeyondPeace logo. |
 Signup Screen Create an account or use Google credentials. |
 Login Screen Log in via email or continue with Google. |
 Home Screen Dashboard with all features at a glance. |
 AI Assessment Gemini-powered dynamic mental health questions. |
 Brain Exercises YouTube-based brain training video library. |
 Music Therapy Curated brain health and meditation music. |
 Specialist Consultation Connect with psychiatrists for support. |
 Special Events Wellness events: yoga, meditation, & more. |
 Medical Reports Upload, store, and view PDF reports. |
 Nearby Hospitals GPS-based hospital finder with Google Maps. |
🤖 AI Chat MindHelper chatbot for mental health support powered by Gemini AI. |
- Fork the repository
- Create a new branch (
git checkout -b feature-branch) - Make your changes
- Commit your changes (
git commit -am 'Add new feature') - Push to the branch (
git push origin feature-branch) - Create a new Pull Request
This project is licensed under the MIT License — see the LICENSE file for details.
For any inquiries or feedback, please contact shoaibinamdar14@gmail.com.
A Google Solution Challenge 2025 Project by Team from A. G. Patil Institute of Technology, Solapur