SoberMeld - AI-Powered Addiction Recovery & Sobriety Tracker | Flutter + NestJS

SoberMeld - AI-Powered Addiction Recovery & Sobriety Tracker | Flutter + NestJS

A complete, production-ready addiction recovery platform built with Flutter, NestJS, and React. Tracks sobriety in real-time, provides AI coaching, recovery milestones, craving management, meditation tools, community support, and gamification — 39 screens across 21 feature modules.

🚀 Key Features

⏱️ Multi-Addiction Sobriety Tracking

• Track 18+ addiction types — alcohol, nicotine, gambling, social media & more

• Real-time sobriety timers with precision down to seconds

• Money saved calculator with customizable daily cost

• Streak tracking with longest streak records

• Relapse logging with emotional context and learnings

• Native iOS & Android home screen widgets (sobriety timer)

🤖 AI Recovery Coach

• GPT-4o-mini via OpenRouter — CBT/DBT-informed responses

• Context-aware to user's addiction type and history

• Personalized affirmation generation

• Trigger pattern analysis and coping suggestions

• Full multi-session conversation history

🏅 55+ Health Recovery Milestones

• Substance-specific milestones — Physical, Mental, Social, Lifestyle categories

• Science-backed data per addiction type (e.g. lung function after quitting smoking)

• Timeline-based visual progress tracking

🆘 Craving Management & SOS Toolkit

• Craving intensity logging (1–10 scale) with trigger documentation

• Emergency SOS contacts with one-tap calling

• Guided craving resistance techniques

• Outcome tracking — resisted vs. gave in

🧘 Meditation & Breathing

• 4-7-8 breathing with animated Lottie guidance

• Body scan meditation, urge surfing, 5-4-3-2-1 grounding

• Guided meditation sessions with audio

• Pre/post mood and craving level tracking

📓 Daily Pledges & Journal

• Morning pledge creation with evening check-in and day rating

• Recovery journal with mood, emotion tagging, and gratitude logging

• Photo and voice note support

👥 Community & Support

• Community feed — stories, milestones, encouragement, questions, tips

• Anonymous posting for sensitive topics · comments and likes

• Recovery meetings finder (AA, NA, SMART Recovery, Refuge Recovery)

• Accountability partners with shared progress visibility

• Family mode — invite loved ones with controlled visibility

🏆 Gamification

• Achievement badges across 10+ categories

• XP points with level progression · daily and weekly challenges

• Streak-based rewards · community leaderboard

⚙️ More Features

• Sleep Tracking — log quality and duration, correlate with recovery progress

• Dopamine Detox — 3-level structured digital detox protocols

• Relapse Prevention Plans — warning signs, coping strategies, emergency contacts

• Replacement Habits — track positive behaviors with streak logging

• Health Integrations — HealthKit (iOS) + Google Fit (Android)

• Push Notifications — Firebase FCM with per-type preferences

• Auth — Email/OTP, Google Sign-In, Apple Sign-In · JWT auto-refresh

• 3 Languages — EN, ES, FR (DE, IT, JA, PT in progress)

🛠️ Tech Stack

📱 Mobile (Flutter)

• Flutter 3.x / Dart — iOS & Android · 21 feature modules, 39 screens

• Riverpod 2.5 · GoRouter (39 named routes + deep linking) · Dio + Socket.IO

• FL Chart · Lottie animations · offline support with Hive

• Native home screen widgets (iOS WidgetKit + Android AppWidget)

• Payments: in_app_purchase (Apple StoreKit + Google Play Billing)

⚙️ Backend (NestJS)

• NestJS 11 (TypeScript) — 28 modules, 34+ tables, 9 migration files

• PostgreSQL 16 · Redis + BullMQ · Socket.IO real-time WebSocket

• AI: OpenRouter (GPT-4o-mini) · Storage: Cloudflare R2 · Email: AWS SES

• 40+ E2E test cases · 3 GitHub Actions CI/CD pipelines · Swagger at /docs

• Stripe web fallback payment integration

🌐 Landing Page

• React 19 + Vite 6 + Tailwind CSS 3

• Privacy, Terms, Cookies, and Data Deletion pages included

💳 Subscription Plans

• Free — 1 addiction, 3 AI credits/day, 5 milestones, basic features

• Premium Monthly — $4.99/mo — Unlimited addictions, unlimited AI, all features

• Premium Yearly — $29.99/yr — Same as monthly, best value

• 7-day free trial · Apple StoreKit + Google Play + Stripe · server-side verification

📦 What's Included

• 📱 Full Flutter source code — iOS & Android (21 modules, 39 screens)

• ⚙️ NestJS backend — 28 modules, 34+ tables, 9 migrations, 40+ E2E tests

• 🌐 React 19 landing page with legal pages

• 🔄 3 GitHub Actions CI/CD pipelines

• 📋 Seed data — 18 addiction types, 55+ milestones, recovery meetings

• 📖 Swagger API docs

✅ Requirements

• Flutter 3.x · Android Studio / Xcode

• Node.js 18+ · PostgreSQL 16+ · Redis 7+

• OpenRouter API key · Firebase project · Cloudflare R2 · AWS SES

🛡️ 18 addiction types. 55+ milestones. AI-powered recovery.  |  📊 28 modules · 34+ tables · 39 screens · home screen widgets