Mood Tracker Assessment - Flutter App

Welcome to Mood Tracker, a comprehensive mobile application designed to help users monitor their emotional well-being through daily mood tracking, journaling, and a rewarding gamification system. The app provides seamless authentication, multilingual support, and dynamic theming for an enhanced user experience.

The design inspirations came from this: Figma user and also from this Dribble page

_{Built by Nkpozi Marcel Kelechi || (X: @Captured-Heart)}

Demo Video

mood_tracker_demo.mp4

This project demonstrates the following Flutter development practices: clean architecture, state management with Riverpod, local data persistence with Hive, and modern UI animations.

Demo Features Overview

- Authentication Flow: Complete user registration/login system with validation and secure storage
- Mood Tracking: Daily mood selection with visual feedback and calendar integration
- Journal Management: Create, edit, delete journal entries with mood associations
- Rewards & Gamification: Point system, achievement badges, and progress tracking
- Localization: Switch between English and German languages seamlessly
- Theme Management: Light, Dark, and System theme modes with user preferences
- API Demo: Integration with OpenLibrary API showcasing REST operations
- Offline Support: Local data persistence with Hive for offline functionality

---

Getting Started

After cloning this repository:

FVM setup

The app runs on:

• Flutter: >=3.29.0
• Dart: >=3.7.0 <4.0.0

Install fvm if not already installed:

dart pub global activate fvm

Install the local flutter version:

fvm install

Dependencies Installation

flutter clean && flutter pub get

Run the Application

flutter run

---

Key Features

🔐 Authentication System

• User Registration & Login with email validation
• Secure Storage using flutter_secure_storage
• Session Management with persistent user data
• Form Validation with custom validators

😔🥳😭😆 Mood Tracking

• Visual Mood Selection (Awesome, Good, Sad, Horrible)
• Daily Mood Limits - One mood entry per day
• Calendar Integration with table_calendar for mood history
• Mood Statistics and trend visualization

📝 Journal Entries

• Rich Text Journaling with Moods with mood associations
• CRUD Operations - Create, Read, Update, Delete entries

🏆 Rewards & Gamification

• Point System based on mood entries (Awesome: 10pts, Good: 5pts, etc.)
• Achievement Badges (Bronze, Silver, Gold, Platinum)
• Progress Tracking with statistics dashboard
• Reward Notifications with confetti animations

🌍 Internationalization

• Multi-Language Support (English, German)
• Dynamic Language Switching with persistent preferences
• Easy Localization Integration

🎨 Dynamic Theming

• Three Theme Modes: Light, Dark, System
• Persistent Theme Preferences using Hive storage

🔗 API Integration

• REST API Demo with OpenLibrary integration
• Network Connectivity checking
• Error Handling with retry mechanisms
• Loading States and user feedback

UI Screenshots

Light Theme Screenshots

Dark Theme Screenshots

Technical Architecture

State Management

• Flutter Riverpod for reactive state management
• AsyncNotifier for handling async operations
• Provider composition for dependency injection

Data Persistence

• Hive Database for local data storage
• Custom Adapters for data serialization
• Secure Storage for sensitive information

Project Structure

lib/
├── constants/          # App constants and enums
├── hive_helper/       # Database configuration
├── src/
│   ├── data/         # Controllers and repositories
│   ├── domain/       # Entities and repository interfaces
│   └── presentation/ # UI components and views
└── utils/            # Utility functions

Tools & Packages

Core Dependencies

• flutter_riverpod: State management solution
• hive: Local database for data persistence
• easy_localization: Internationalization support
• dio: HTTP client for API calls
• table_calendar: Calendar widget for mood history

UI & Animation

• flutter_animate: Rich animations
• flutter_slidable: Swipe actions for list items
• confetti: Celebration animations

Utilities

• flutter_secure_storage: Secure data storage
• uuid: Unique identifier generation
• internet_connection_checker_plus: Network connectivity

Development Patterns

• Clean Architecture with clear separation of concerns
• Repository Pattern for data abstraction
• MVVM Pattern with Riverpod state management
• Dependency Injection for testable code
• Error Handling with custom result types

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

Made with 💜 by Nkpozi Marcel Kelechi

Twitter • GitHub • LinkedIn • Medium