Skip to content

Repository files navigation

🧠 MindMate - Your Mental Wellness Companion

1_readme_header

Making mental health support accessible, affordable, and beautiful for everyone

Repository Overview

MindMate is a comprehensive mental health companion ecosystem consisting of:

  1. MindMate App - Feature-rich web/PWA application for daily mental wellness tracking
  2. MindMate Website - Marketing & authentication gateway for user onboarding

What is MindMate?

MindMate is a comprehensive mental wellness platform that empowers you to take control of your mental health with privacy, ease, and AI-powered support.

🎯 Mission

To empower individuals to take control of their mental health through an intuitive, private, and AI-assisted wellness platform that works entirely offline with no data shared to external servers.

✨ Core Features

2_readme_features_grid
  • πŸ“Š Mood Tracking - Track emotional patterns and identify triggers
  • πŸ“” Private Journaling - Write and reflect on your thoughts securely
  • 😴 Sleep Monitoring - Track sleep quality and patterns
  • 🎯 Habit Building - Build positive habits with visual streaks
  • 🧠 CBT Exercises - Guided therapeutic techniques
  • πŸ€– AI Companion - 24/7 TheraBot for mental health support
  • πŸ”’ 100% Private - All data stored locally, zero cloud sync
  • πŸ“± Offline First - Works without internet connection

πŸ’» Tech Stack

Component Technology
UI React 19, TypeScript
Styling Tailwind CSS
Storage Dexie.js (IndexedDB)
AI Google Gemini
Build Vite

πŸ” Privacy & Security

βœ… 100% Local Storage - Your data stays on your device
βœ… No Cloud Sync - Nothing is sent to servers
βœ… Encrypted - End-to-end encryption
βœ… Open Source - Transparent, community-driven
βœ… GDPR Compliant - Your rights protected

πŸ“‚ Project Structure

mindmate/
β”œβ”€β”€ MindMate-App/              # React web application
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ components/        # UI components
β”‚   β”‚   β”œβ”€β”€ services/          # Business logic
β”‚   β”‚   β”œβ”€β”€ types/             # TypeScript types
β”‚   β”‚   └── utils/             # Helper functions
β”‚   β”œβ”€β”€ package.json
β”‚   β”œβ”€β”€ vite.config.ts
β”‚   └── README.md
β”‚
β”œβ”€β”€ MindMate-Website/          # Marketing website
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ pages/             # Page components
β”‚   β”‚   β”œβ”€β”€ components/        # Reusable components
β”‚   β”‚   β”œβ”€β”€ sections/          # Page sections
β”‚   β”‚   └── services/          # API integration
β”‚   β”œβ”€β”€ package.json
β”‚   β”œβ”€β”€ tailwind.config.js
β”‚   └── README.md

πŸš€ Quick Start

Get the App Running

# Clone & install
git clone https://github.com/mindmate/mindmate.git
cd mindmate-app
npm install

# Start development
npm run dev

Open http://localhost:5173

Get the Website Running

cd mindmate-website
npm install
npm run dev

πŸ“¦ What You Get

App Website
Mood tracking & analytics Landing page
Journal with search Sign up/Login
Sleep monitoring Dashboard
Habit builder User profile
CBT exercises Settings
AI chat (TheraBot) Resources hub
Dark mode Responsive design

πŸ› Known Issues & Limitations

Current Limitations

  • No real-time collaboration
  • Single-user per device (local storage)
  • Browser storage size limit (~50MB)
  • No data backup to cloud (optional in future)

Future Enhancements

  • Cloud data synchronization
  • Shared mental health groups
  • Video consultation integration
  • Wearable device integration
  • Mobile native apps (React Native)
  • Multilingual support
  • Advanced analytics dashboard
  • Professional therapist integration

πŸ“ˆ Analytics & Monitoring

Metrics to Track

  • User engagement
  • Feature usage
  • Error rates
  • Performance metrics
  • User retention
  • Sign-up conversion

πŸŽ“ Learning Resources

For Developers

Mental Health Resources

⚠️ Important Disclaimer

MindMate is a wellness tool, not a replacement for professional mental health care.

πŸ“ž Support

πŸ“„ License

MIT License - Open source and free to use

Made with ❀️ for mental wellness

5_cta_button

Home β€’ Docs β€’ Issues

v1.0.0 β€’ MIT License

About

MindMate is a mental health chatbot that assists users by facilitating mood assessments, offering tailored coping strategies, and providing simulated crisis notifications. It prioritizes empathy, responsible management of delicate situations, and actionable advice for emotional wellness.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors