Description
CalmAI – AI Mental Health & Wellness Companion App (Flutter)
CalmAI — AI-Powered Mental Health & Wellness Companion
CalmAI is a complete Flutter source code for a mental wellness app (Android + iOS + Web Admin Panel). It combines an AI therapy chatbot, mood tracking, guided journaling, CBT thought records, breathing exercises, a gratitude journal, mood analytics, and weekly AI-generated wellness reports — all in a Living Sanctuary design (forest green palette, Newsreader + Manrope typography) with full dark mode support.
Includes a web-based admin panel with dashboard, user management, crisis conversation moderation, analytics, configuration editor, reports with CSV export, and audit log.
Built for developers who want to launch a mental health app quickly — everything is wired, tested, and ready to publish.
✨ Key Features
- AI Therapy Chat — GPT-4o or Gemini-powered chatbot with CBT-based responses, conversation history, and conversation starters
- Mood Logging — 8 mood types, 1–5 intensity slider, trigger tags, and instant AI mood acknowledgment
- Guided Journal — Free write, AI-prompted, and CBT thought record (6-step) with AI review
- 5 Breathing Exercises — Box breathing, 4-7-8, deep calm, energize, sleep wind-down — fully animated, 100% offline
- Gratitude Journal — Daily 3-item entry, streak tracking, and a scrollable gratitude jar
- Mood Analytics — Trend charts, pattern insights, and wellness score (fl_chart)
- Weekly AI Wellness Report — Personalized summary of wins, insights, and next-week intention (premium)
- Morning Affirmation — Personalized AI affirmation on the home dashboard
- Crisis Safety System — Client-side keyword detection, offline crisis resources (US/UK/AU/CA/International), always-visible professional help link
- Premium IAP — RevenueCat monthly + annual subscriptions, paywall screen
- AdMob Ads — Banner + interstitial, fully optional (disable via Remote Config)
- Dark Mode — Full dark theme with persisted user preference
- Firebase Auth — Email/password, Google Sign-In, Anonymous (guest mode)
- Push Notifications — Daily check-in reminders, streak alerts, weekly report
- GDPR-Ready — Full data export + one-tap account & data deletion
- Web Admin Panel — Dashboard with KPIs, user management (search, toggle premium, GDPR delete), crisis conversation moderation, mood analytics with charts, runtime configuration editor, weekly reports with CSV export, and immutable audit log
- Firebase Hosting — One-command deployment for the admin panel
- 160+ Unit Tests — Crisis detection, mood patterns, validators, all enums
Tech Stack
- Flutter 3.41 / Dart 3.11 — Android + iOS + Web Admin
- State Management: Riverpod 2.x
- Navigation: GoRouter 14.x
- Backend: Firebase (Auth, Firestore, Remote Config, FCM)
- AI: OpenAI GPT-4o + Google Gemini 1.5 Pro (switchable via Remote Config)
- IAP: RevenueCat
- Ads: Google AdMob
- Data Models: Freezed + JSON serializable
- Charts: fl_chart 0.69
What’s Included
- Full Flutter source code — 25 mobile screens + 11 admin screens, clean architecture
- Web admin panel with dashboard, user management, moderation, analytics, config, reports, audit log
- All 5 breathing exercise animations (offline, no API)
- Offline crisis resource database (5 regions)
- Complete Firebase Firestore security rules
- Firebase Hosting config for admin panel deployment
- 160+ unit tests
- Offline HTML documentation + Quick Start Guide
⚙️ Requirements
- Flutter 3.41.x (stable channel)
- Firebase project (free Spark plan works for development)
- OpenAI API key or Google Gemini API key
- RevenueCat account (free tier available)
- AdMob account (optional — leave empty to disable all ads)
