CalmAI – AI Mental Health Wellness Companion App (Flutter)

CalmAI is a complete Flutter source code for a mental wellness mobile app (Android + iOS). 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 soft, calming lavender design with full dark mode support.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
Tech Stack
Flutter 3.24 / Dart 3.5 — Android + iOS
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 screens, clean architecture
All 5 breathing exercise animations (offline, no API)
Offline crisis resource database (5 regions)
Complete Firebase Firestore security rules
Offline HTML documentation + Quick Start Guide
⚙️ Requirements
Flutter 3.24.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)