AI-powered emotional diary that understands and comforts you
- 🧠 AI Emotion Analysis — Real-time emotion detection powered by Groq Llama 3.3
- 💬 Empathetic AI Characters — Personalized comfort messages from AI companions
- 🌱 Emotion Calendar — Visualize your emotional journey as growing plants
- 📊 Statistics & Trends — Emotion charts, keyword analysis, and weekly insights
- 📸 Image Analysis — Detect emotions in photos via Vision API
- 🔔 Smart Notifications — Morning encouragement & evening care across 2 channels
- 🔒 Privacy-First — 100% local storage, no cloud sync, no server uploads
- ✅ 1,505 tests all passing — expanded test coverage with UI & integration tests
- 🎯 Provider invalidation chain — fixed diary list refresh bug with proper state management
- 🧪 FCM integration tests — comprehensive notification flow testing (foreground/background/killed states)
- ♻️ UX pattern restoration — simplified "view more" interaction with toggle buttons
- 🗑️ Code cleanup — removed 370 lines of unused bottom sheet code for better maintainability
Previous Updates (v1.4.38)
- 📬 Weekly Insights — Every Sunday evening, receive a summary of your emotional week
- 🧠 Cognitive Pattern Detection — AI detects cognitive distortions and sends CBT messages
- 🎯 Emotion-Aware Messages — Notifications prioritize messages matching your recent emotional state
- 💙 Safety Follow-up — 24-hour check-in after crisis detection
- 📈 Emotion Trend Analysis — Automatic insights when mood patterns change
Your mind belongs to you.
| Item | Policy |
|---|---|
| Storage | Local SQLite only — never leaves your device |
| AI Analysis | Anonymous text sent to Groq API, no personal data |
| Cloud Sync | None — no accounts, no servers |
| Deletion | Instant full deletion from Settings |
See Privacy Policy for details.
| Category | Technology | Version |
|---|---|---|
| Framework | Flutter / Dart | 3.38.x / ^3.10.1 |
| State | Riverpod | 2.6.1 |
| Database | SQLite (sqflite) | 2.3.3 |
| Firebase | Analytics, Crashlytics, FCM | 3.8.0+ |
| Routing | go_router | 17.0.1 |
| AI | Groq API | llama-3.3-70b-versatile |
| Charts | fl_chart | 0.68.0 |
┌──────────────────────────────────────────┐
│ Presentation │
│ Providers (Riverpod) + Widgets │
├────────────────────┬─────────────────────┤
│ ▼ │
│ Domain │
│ Entities, UseCases, Repo Interfaces │
├────────────────────┬─────────────────────┤
│ ▲ │
│ Data │
│ Repo Impl, DataSources, DTOs │
└──────────────────────────────────────────┘
Layer rules: presentation → domain ← data
(domain has zero external dependencies)
- Flutter 3.38.x / Dart 3.10.x
- A Groq API key
# Clone
git clone https://github.com/kaywalker91/MindLog.git
cd MindLog
# Install dependencies
flutter pub get
# Generate code (freezed, json_serializable, etc.)
dart run build_runner build --delete-conflicting-outputs
# Run
flutter run --dart-define=GROQ_API_KEY=your_key# Release App Bundle
flutter build appbundle --release --dart-define=GROQ_API_KEY=your_key
# Release APK
flutter build apk --release --dart-define=GROQ_API_KEY=your_keylib/
├── core/ # Config, services, theme, constants, utilities
├── data/ # Repository implementations, DataSources, DTOs
├── domain/ # Pure Dart: entities, repository interfaces, use cases
├── presentation/ # Providers, Screens, Widgets
└── main.dart
# Run all tests with coverage
./scripts/run.sh test
# Full quality gates (lint + format + test)
./scripts/run.sh qualityCoverage targets: unit ≥ 80%, widget ≥ 70%
Bug reports, feature requests, and pull requests are welcome!
See CONTRIBUTING.md for guidelines.
See CHANGELOG.md for full release notes.
MIT License — Copyright (c) 2024 kaywalker91