MindSync

A modern Android wellness and productivity app built with Jetpack Compose and Material 3 design. MindSync helps you track workouts, meditation, skincare routines, medicines, period and pregnancy health, sleep, reminders, and more — all in one beautifully designed dark-themed application.

Features

🏋️ Workout Tracking

• Start empty workouts or use routines
• Log exercises with sets, reps, and weight
• Track workout duration, volume, and progress
• Browse exercises by muscle group
• Personal records tracking

🧘 Meditation

• Guided meditation sessions
• Breathing exercises
• Session tracking and streaks
• Category-based meditation library

💊 Medicine & Supplements

• Track medications and supplements
• Set reminders for doses
• Manage dosage schedules

🛁 Skincare Routines

• Morning and evening routines
• Step-by-step tracking
• Streak tracking for consistency

😴 Sleep Tracker

• Set bedtime and wake time goals
• Track sleep quality
• View sleep history and patterns

💧 Water Intake

• Daily hydration goals
• Track glasses of water
• Visual progress indicators

🛒 Grocery List

• Add and manage grocery items
• Mark items as purchased
• Share lists with others

📚 Student Tools

• Assignment tracking
• Due date reminders
• Status management (pending, in progress, completed)

🚗 Vehicle Maintenance

• Track multiple vehicles
• Maintenance reminders
• Service history

🎂 Birthdays & Events

• Never forget important dates
• Gift idea notes
• Upcoming events view

💰 Bills & Payments

• Track recurring bills
• Due date reminders
• Payment status tracking

🌸 Period & Pregnancy Tracker

• Period mode, pregnancy mode, and trying-to-conceive mode
• Cycle predictions with next period, cycle day, fertile window, ovulation date, and current phase
• Pregnancy week, trimester, due-date progress, days remaining, and baby-size guidance
• Daily logging for flow level, symptoms, mood, temperature, weight, intimacy, and notes
• Health records for doctor appointments, medicine, food/nutrition, and doctor's notes
• Calendar view with editable dates, markers, details, and animated month navigation
• Reminder lead times for appointments and medicine: at time, 15 minutes before, 1 hour before, or 1 day before

🔔 Unified Reminders

• Unified timeline for medicines, appointments, birthdays, skincare, water, sleep, workout, meditation, bills, assignments, vehicle care, and other reminders
• Notification categories for health and wellness reminders
• Custom vibration patterns by reminder type
• Quick actions in the reminders hub for marking items done and snoozing reminders

📊 Dashboard & Insights

• Smart dashboard summary cards for next medicine, today's workout, cycle status, sleep goal, and bills due soon
• Monthly trend charts for workout volume, meditation minutes, medicine adherence, cycle days, and mood/symptom patterns
• Cycle insights with average cycle length, average period length, cycles tracked, and symptom trends

Tech Stack

Technology	Purpose
Kotlin	Primary language
Jetpack Compose	Modern declarative UI
Material 3	Design system
Firebase Auth	User authentication
Firebase Firestore	Cloud database
Firebase Storage	File storage
Koin	Dependency injection
Coroutines & Flow	Asynchronous programming
Navigation Compose	Screen navigation
Room	Local database

Architecture

MindSync follows Clean Architecture principles with MVVM pattern:

app/
├── data/
│   ├── local/          # Room database, DataStore
│   ├── remote/         # Firebase services
│   └── repository/     # Repository implementations
├── di/                 # Koin modules
├── domain/
│   ├── model/          # Domain models
│   ├── repository/     # Repository interfaces
│   └── usecase/        # Business logic
└── presentation/
    ├── auth/           # Login/Register screens
    ├── dashboard/      # Main dashboard
    ├── workout/        # Workout tracking
    ├── meditation/     # Meditation features
    ├── medicine/       # Medicine tracking
    ├── skincare/       # Skincare routines
    ├── lifestyle/      # Sleep, water, bills, etc.
    ├── navigation/     # Navigation graph
    ├── theme/          # App theming
    └── components/     # Reusable composables

Theme

MindSync features a modern dark theme with blue accents:

Color	Hex	Usage
Dark Background	#0D0D0D	Screen backgrounds
Card Background	#1A1A1A	Cards and surfaces
Blue Accent	#4A90D9	Primary actions, FABs
Purple Accent	#6B5CE7	Secondary accents

Requirements

• Android Studio: Hedgehog or newer
• Min SDK: 24 (Android 7.0)
• Target SDK: 36
• JDK: 11+

Setup

1. Clone the repository

   git clone https://github.com/suman9259/MindSync.git
   cd MindSync

2. Firebase Setup

   • Create a Firebase project at Firebase Console
   • Enable Authentication providers used by the app: Email/Password, Google Sign-In, and Phone if phone login is enabled
   • Enable Firestore Database and Firebase Storage
   • Download google-services.json and place it in app/
   • Do not commit google-services.json because it is environment-specific
   • Add Firestore security rules so each user can only read/write their own user-scoped data

3. Build the project

   ./gradlew assembleDebug

4. Run on device/emulator

   ./gradlew installDebug

Building

Debug Build

./gradlew assembleDebug

Release Build

./gradlew assembleRelease

Screenshots

Add real screenshots or GIFs to docs/screenshots/ using these filenames:

Dashboard	Period Tracker	Workout
dashboard.png	period-tracker.gif	workout.png

Meditation	Reminders	Insights
meditation.png	reminders.png	insights.png

Privacy & Security

MindSync stores sensitive wellness and health information. The app is designed with privacy in mind:

• Local data is stored in an encrypted Room database using SQLCipher.
• Firebase Auth identifies the signed-in user for cloud-backed features.
• Firestore/Storage data must be scoped per user with strict security rules.
• Android notification permission is required for reminders on modern Android versions.
• Health reminders can include appointment/medicine details, so notification privacy settings should be considered.
• Data export/import should be offered to users for portability and account deletion workflows.
• Users should be able to delete their local and cloud data from account settings before release.

Roadmap

• Cloud sync for Room data with offline-first conflict handling
• JSON/CSV export and import for backup and portability
• AI wellness coach with daily personalized suggestions
• Wear OS support for workouts, heart rate, steps, and sleep
• Home screen widgets for water, medicine, cycle countdown, workout streak, and meditation timer
• Unified calendar for assignments, appointments, bills, birthdays, vehicle maintenance, cycle, and medicine
• Gamification with streak badges, weekly goals, wellness score, and achievements
• Accessibility upgrades: larger text mode, high contrast mode, TalkBack labels, and reduced motion
• CI with GitHub Actions for tests and debug builds
• ProGuard/R8 release hardening and signing documentation
• Future modularization into feature-workout, feature-period, feature-reminders, core-data, and core-ui

Product Ideas

AI Wellness Coach

• Daily suggestions based on sleep, cycle symptoms, missed medicine doses, workout history, and meditation streaks
• Examples: “You slept less than usual; try light meditation.” and “Your cycle symptoms are trending higher this week.”

Wear OS Integration

• Sync workouts, heart rate, steps, and sleep from wearable devices
• Add quick reminder completion from the watch

Home Screen Widgets

• Water counter
• Medicine reminder
• Cycle countdown
• Workout streak
• Meditation timer

Unified Calendar

• One calendar for assignments, appointments, bills, birthdays, vehicle maintenance, cycle predictions, and medicine schedules

Gamification

• Streak badges
• Weekly goals
• Wellness score
• Achievement unlocks

Accessibility

• Larger text mode
• High contrast mode
• Better TalkBack labels
• Reduced motion option

Engineering Readiness

• Add unit tests for ViewModels and cycle prediction logic
• Add Room DAO tests
• Add UI tests for dashboard, tracker, reminders, and insights
• Add reminder scheduling tests
• Run ./gradlew test assembleDebug on pull requests
• Keep release signing keys outside the repository

Contributing

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

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Jetpack Compose - Modern Android UI toolkit
• Material Design 3 - Design system
• Firebase - Backend services
• Koin - Dependency injection framework