🧘🏻 MindHaven

\

MindHaven is an app made using flutter which is Your personal sanctuary for mental wellness, self-care, and mindful journaling.

---

🚀 Quick Start

1. Clone the repository:

   git clone <repository-url>
   cd MindHaven

2. Install dependencies:

   flutter pub get

3. Run the app:

   flutter run

---

🌱 App Icon Setup

1. Save your nature-themed image as assets/images/nature.png (1024x1024px recommended).
2. Run:

   flutter pub get
   flutter pub run flutter_launcher_icons
   

3. Icons will be generated for all platforms automatically.
   • Android: android/app/src/main/res/
   • iOS: ios/Runner/Assets.xcassets/AppIcon.appiconset/

✨ Features

🔒 Privacy-First

• Complete offline functionality
• Local storage only
• No account required
• No data collection

📝 Smart Journaling

• Daily journal entries
• Modern text interface
• Save / Edit Journals

😊 Mood Tracking

• Log daily mood
• 5 mood options with emojis
• Mood trends & analytics
• Visual indicators
• Activity tracking
• Historical visualization

🌟 Daily Affirmations

• Curated positive affirmations
• New affirmation each day
• Favorite & browse affirmations
• Animated card display
• Share affirmations (coming soon)

🔔 Smart Reminders

• Journal, affirmation, and mood reminders
• Customizable times
• Native notifications

📱 Modern UI/UX

• Material Design 3
• Dark/Light theme
• Smooth animations
• Intuitive navigation
• Responsive & accessible

---

🛠 Technical Architecture

Frontend

• Flutter 3.x - Cross-platform
• Provider - State management
• Material Design 3 - UI
• Google Fonts - Typography

Local Storage

• SQLite - Local DB
• SharedPreferences - Settings
• Structured models

Notifications

• Flutter Local Notifications
• Timezone support
• Custom channels

---

📁 Project Structure

lib/
├── main.dart                 # App entry point
├── models/                   # Data models
│   ├── journal_entry.dart
│   ├── mood_entry.dart
│   └── affirmation.dart
├── providers/                # State management
│   ├── journal_provider.dart
│   ├── mood_provider.dart
│   ├── affirmation_provider.dart
│   └── notification_provider.dart
├── services/                 # Business logic
│   ├── database_service.dart
│   ├── emotion_detection_service.dart
│   └── notification_service.dart
├── screens/                  # UI screens
│   ├── splash_screen.dart
│   ├── home_screen.dart
│   ├── journal_screen.dart
│   ├── mood_tracker_screen.dart
│   ├── history_screen.dart
│   └── settings_screen.dart
├── widgets/                  # Reusable components
│   ├── affirmation_card.dart
│   ├── journal_entry_card.dart
│   ├── mood_entry_card.dart
│   └── quick_stats_card.dart
└── utils/                    # Utilities
    └── app_theme.dart

---

⚙️ Setup Instructions

Prerequisites

• Flutter SDK 3.x
• Dart SDK 3.x
• Android Studio / VS Code
• Android SDK (Android)
• Xcode (iOS)

Installation

See Quick Start above.

Platform-Specific Setup

Android

• Min SDK: 21
• Target SDK: 34
• Notification permissions configured

iOS

• Min iOS: 12.0
• Notification permissions auto-handled
• Core ML ready

---

📦 Key Dependencies

dependencies:
  flutter:
    sdk: flutter
  provider: ^6.0.5           # State management
  sqflite: ^2.3.0           # Local database
  google_fonts: ^6.1.0      # Typography
  flutter_local_notifications: ^16.3.0  # Notifications
  intl: ^0.18.1             # Internationalization
  shared_preferences: ^2.2.2 # Settings storage
  tflite_flutter: ^0.10.4   # TensorFlow Lite (Android)

---

---

🔮 Future Enhancements

Phase 2 Features

• Data export functionality
• Backup/restore options
• Advanced analytics dashboard
• Custom affirmation creation
• Voice-to-text journaling
• Meditation timer integration

Technical Improvements

• Real ML model integration
• Performance optimizations
• Advanced security features
• Accessibility improvements
• Multi-language support

Analytics Enhancements

• Mood correlation analysis
• Goal setting and tracking
• Progress milestones
• Detailed trend analysis
• Personalized insights

---

🔐 Privacy & Security

• No Network Requests - App works completely offline
• Local Encryption - Sensitive data is encrypted at rest
• No Analytics - No user behavior tracking
• No Ads - Clean, distraction-free experience
• Open Source - Code is transparent and auditable

---

⚠️ Mental Health Disclaimer

This app is designed for self-reflection and emotional awareness. It is not intended to replace professional mental health care, therapy, or medical advice. If you're experiencing severe mental health symptoms, please consult with a qualified healthcare provider.

---

🤝 Contributing

We welcome contributions! Please read our contributing guidelines and code of conduct before submitting pull requests.

---

📄 License

MIT License - see the LICENSE file for details.

---

💬 Support

If you find this app helpful, please:

• ⭐ Star the repository
• 🐛 Report bugs
• 💡 Suggest features
• 📱 Share with others

---

Built with ❤️ for mental health awareness