🧠 MindCure

A Comprehensive Mental Health & Wellness Platform for Students

Empowering students with AI-powered therapy, mood tracking, peer support, and professional counseling — all in one place.

Features • Tech Stack • Getting Started • Screenshots • API • Contributing

📸 Screenshots

Beautiful, intuitive dashboard with mood tracking, appointments, and quick access to all features

✨ Features

🤖 AI-Powered Therapy Chat

24/7 Support: Google Gemini-powered mental health chatbot available anytime
Crisis Detection: Intelligent detection of distressing content with immediate resources
Empathetic Responses: Trained to provide compassionate, helpful support
Conversation History: Review past conversations for reflection

📊 Mood Tracking & Analytics

Daily Check-ins: Log your mood with a simple, beautiful interface
Emotion Tagging: Track specific emotions and triggers
Visual Progress: Beautiful charts showing mood patterns over time
Insights: AI-generated insights about your mental health journey

👥 Support Circle (Social Features)

Friend System: Connect with classmates and peers who care
Real-time Messaging: Private chat with friends in your support circle
User Profiles: View friends' profiles and track their wellness journey
Friend Requests: Send and receive friend requests with notifications

🏆 Gamification & Achievements

XP System: Earn experience points for healthy habits
Badges: Unlock achievements like "First Check-in", "Week Streak", "Mood Helper"
Progress Tracking: Visual progress toward next achievements
Engagement Rewards: Stay motivated with gamified wellness activities

📅 Counselor Appointments

Book Sessions: Schedule appointments with professional counselors
Available Slots: View counselor availability in real-time
Appointment Management: View, reschedule, or cancel appointments
Video Integration: Seamless video calling for virtual sessions

📚 Self-Help Resources

Guided Exercises: Breathing exercises, meditation, and mindfulness
Educational Content: Articles and videos on mental health topics
Coping Strategies: Evidence-based techniques for managing stress
Emergency Resources: Quick access to crisis hotlines

🚨 Crisis Intervention

Crisis Detection: AI monitors for emergency situations
Immediate Resources: One-tap access to helplines
Safety Planning: Tools to create personalized safety plans
Professional Referrals: Guidance to seek professional help

👨‍💼 Role-Based Dashboards

Student Dashboard: Full access to all wellness features
Counselor Dashboard: Manage appointments, view student progress
Admin Dashboard: User management, analytics, system oversight

🔔 Smart Notifications

Friend Activity: Get notified when friends need support
Appointment Reminders: Never miss a counseling session
Achievement Alerts: Celebrate when you unlock new badges
Check-in Reminders: Gentle nudges to log your mood

🛠️ Tech Stack

Frontend

Technology	Purpose
	UI Framework
	Build Tool & Dev Server
	Styling
	Navigation
	Icons
	Data Visualization

Backend

Technology	Purpose
	Runtime
	API Framework
	Database
	ODM
	Authentication

AI & APIs

Technology	Purpose
	AI Chat & Analysis

Deployment

Platform	Service
	Frontend Hosting
	Backend API
	Cloud Database

🚀 Getting Started

Prerequisites

# Required
Node.js 18+ 
npm or yarn

# Optional (for AI features)
Google Gemini API Key

Installation

# 1. Clone the repository
git clone https://github.com/Lullucoder/MindCure.git
cd MindCure

# 2. Install frontend dependencies
npm install

# 3. Install backend dependencies
cd server
npm install
cd ..

# 4. Set up environment variables
cp .env.example .env
# Edit .env with your configuration

Environment Variables

Frontend (`.env`)

VITE_API_URL=http://localhost:5000/api
VITE_GEMINI_API_KEY=your_gemini_api_key

Backend (`server/.env`)

PORT=5000
MONGODB_URI=mongodb+srv://your_connection_string
JWT_SECRET=your_jwt_secret
NODE_ENV=development

Running the Application

# Terminal 1: Start the backend server
cd server
npm run dev

# Terminal 2: Start the frontend
npm run dev

Open your browser and navigate to http://localhost:5173

📁 Project Structure

MindCure/
├── 📂 src/                    # Frontend source code
│   ├── 📂 components/         # Reusable UI components
│   │   ├── 📂 auth/          # Authentication components
│   │   ├── 📂 chat/          # AI Chat interface
│   │   ├── 📂 community/     # Forum & community features
│   │   ├── 📂 layout/        # Layout components (Navbar, Footer)
│   │   ├── 📂 mood/          # Mood tracking components
│   │   ├── 📂 social/        # Friends, Messages, Achievements
│   │   └── 📂 ui/            # Base UI components
│   ├── 📂 context/           # React Context providers
│   ├── 📂 hooks/             # Custom React hooks
│   ├── 📂 pages/             # Page components
│   ├── 📂 services/          # API service functions
│   └── 📂 utils/             # Utility functions
├── 📂 server/                 # Backend source code
│   └── 📂 src/
│       ├── 📂 config/        # Configuration files
│       ├── 📂 controllers/   # Route controllers
│       ├── 📂 middleware/    # Express middleware
│       ├── 📂 models/        # Mongoose models
│       ├── 📂 routes/        # API routes
│       └── 📄 index.js       # Server entry point
├── 📂 public/                 # Static assets
└── 📄 package.json           # Dependencies

🎨 Design System

Color Palette

Color	Hex	Usage
🔵 Primary	`#0ea5e9`	Main actions, links, branding
🟣 Accent	`#8b5cf6`	Highlights, special elements
🟢 Success	`#22c55e`	Positive feedback, completed states
🟡 Warning	`#f59e0b`	Warnings, pending states
🔴 Danger	`#ef4444`	Errors, crisis situations
⚪ Neutral	`#64748b`	Secondary text, borders

Typography

Headings: Bold, Modern styling
Body: Clean, Readable fonts
Responsive: Scales beautifully across devices

📱 Responsive Design

MindCure is fully responsive and optimized for all devices:

Device	Features
📱 Mobile	Bottom navigation, touch-friendly controls, hamburger menu
📱 Tablet	Optimized layouts, touch interface
💻 Desktop	Full-featured experience with expanded navigation

🔌 API Documentation

Authentication Endpoints

POST   /api/auth/register     # Register new user
POST   /api/auth/login        # Login user
GET    /api/auth/me           # Get current user

Mood Tracking

GET    /api/mood              # Get mood entries
POST   /api/mood              # Create mood entry
GET    /api/mood/stats        # Get mood statistics

Friends & Social

GET    /api/friends           # Get friends list
POST   /api/friends/request   # Send friend request
PUT    /api/friends/:id       # Accept/reject request

Messages

GET    /api/messages/conversations  # Get conversations
POST   /api/messages               # Send message
GET    /api/messages/:conversationId # Get messages

Achievements

GET    /api/achievements       # Get user achievements

🔒 Security & Privacy

🔐 JWT Authentication: Secure token-based auth
🔒 Password Hashing: bcrypt encryption
🛡️ CORS Protection: Configured for production domains
📝 Input Validation: Server-side validation with Zod
🚫 Rate Limiting: API rate limiting to prevent abuse
🔏 Privacy First: Minimal data collection

🆘 Crisis Support

Emergency Contacts (India)

Service	Number	Description
📞 Tele-MANAS	`14416`	National Mental Health Helpline
🚑 Emergency	`112`	Police/Fire/Ambulance
💚 KIRAN Helpline	`1800-599-0019`	24/7 Mental Health Support
👩 Women Helpline	`181`	Women in distress
👶 CHILDLINE	`1098`	Child protection

🧪 Testing

# Run unit tests
npm run test

# Run with coverage
npm run test:coverage

# Run e2e tests
npm run test:e2e

🚀 Deployment

Frontend (Vercel)

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel --prod

Backend (Render)

Connect your GitHub repository to Render
Set environment variables in Render dashboard
Deploy automatically on push to main

Live API: https://mindcure-api.onrender.com

🤝 Contributing

We welcome contributions! Please follow these steps:

Fork the repository
Create a feature branch
```
git checkout -b feature/amazing-feature
```
Commit your changes
```
git commit -m 'Add amazing feature'
```
Push to the branch
```
git push origin feature/amazing-feature
```
Open a Pull Request

Code Style

Use ESLint configuration provided
Follow React best practices
Write meaningful commit messages
Add tests for new features

📄 License

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

⚠️ Disclaimer

Important: This platform provides mental health support but is not a substitute for professional medical care. If you're experiencing a mental health emergency, please contact:

Tele-MANAS: 14416

Emergency Services: 112

💙 Acknowledgments

Google Gemini for AI capabilities
The open-source community for amazing tools
Mental health professionals who provided guidance
All contributors and testers

Made with 💙 for Student Mental Health

⬆️ Back to Top

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
public		public
server		server
src		src
.env.example		.env.example
.env.production.example		.env.production.example
.gitignore		.gitignore
CHAT_UX_IMPROVEMENTS.md		CHAT_UX_IMPROVEMENTS.md
GEMINI_MODELS.md		GEMINI_MODELS.md
RATE_LIMITING.md		RATE_LIMITING.md
README.md		README.md
THERAPY_CHATBOT_GUIDE.md		THERAPY_CHATBOT_GUIDE.md
eslint.config.js		eslint.config.js
index.html		index.html
jsconfig.json		jsconfig.json
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.js		tailwind.config.js
vercel.json		vercel.json
vite.config.js		vite.config.js

Latest commit

History

Folders and files

Repository files navigation