Skip to content

Repository files navigation

🧠 MindMate - Your Mental Wellness Companion

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

🎯 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.

✨ Core Features

  • 📊 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
mindmate_features_perfect

🚀 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

🎨 Project Structure

mindmate/
├── apps/
│   ├── mindmate-app/        ← The main application
│   └── mindmate-website/    ← Marketing & authentication

💻 Tech Stack

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

🔐 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

mindmate_privacy_security

📦 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

🤝 Contributing

We welcome contributions!

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

See CONTRIBUTING.md for guidelines.

⚠️ Important Disclaimer

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

Crisis Resources

📄 License

MIT License - Open source and free to use

📞 Support

Made with ❤️ for mental wellness

HomeDocsIssues

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