🌸 MindBloom — Mental Health & Wellness Tracker

A beautiful, full-stack wellness app to track your moods, journal your thoughts, and discover your mental health patterns.

---

🧭 Project Overview

MindBloom is a unique mental wellness platform built with:

• Frontend: ReactJS + Tailwind CSS (Vite)
• Backend: Python FastAPI + SQLite (via SQLAlchemy)
• Auth: JWT-based authentication with bcrypt password hashing

---

📦 5 Modules

#	Module	Route	Description
1	Login	/login	Secure sign-in with JWT
2	Signup	/signup	Register with custom avatar
3	Dashboard	/dashboard	Overview, stats, quick actions
4	Mood Tracker	/mood	Log moods with emoji, energy, sleep
5	Journal	/journal	Private journaling with mood tags
+	Analytics	/analytics	Charts, patterns, activity insights

---

🚀 Quick Start

Prerequisites

• Python 3.8+
• Node.js 18+

Option 1: Automated (Mac/Linux)

chmod +x start.sh
./start.sh

Option 2: Automated (Windows)

Double-click start.bat

Option 3: Manual Setup

Backend:

cd backend
python -m venv venv
source venv/bin/activate      # Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn main:app --reload --port 8000

Frontend (new terminal):

cd frontend
npm install
npm run dev

---

🌐 URLs

Service	URL
App	http://localhost:5173
API	http://localhost:8000
API Docs	http://localhost:8000/docs

---

🗂️ Project Structure

mindbloom/
├── backend/
│   ├── main.py          # FastAPI app, all routes
│   ├── models.py        # SQLAlchemy DB models
│   ├── schemas.py       # Pydantic request/response schemas
│   ├── database.py      # DB connection (SQLite)
│   └── requirements.txt
│
├── frontend/
│   ├── src/
│   │   ├── pages/
│   │   │   ├── Login.jsx       # Module 1
│   │   │   ├── Signup.jsx      # Module 2
│   │   │   ├── Dashboard.jsx   # Module 3
│   │   │   ├── MoodTracker.jsx # Module 4
│   │   │   ├── Journal.jsx     # Module 5
│   │   │   └── Analytics.jsx   # Bonus
│   │   ├── components/
│   │   │   └── Layout.jsx      # Sidebar + navigation
│   │   ├── context/
│   │   │   └── AuthContext.jsx # Auth state management
│   │   ├── utils/
│   │   │   └── api.js          # Axios API client
│   │   ├── App.jsx             # Routes
│   │   ├── main.jsx
│   │   └── index.css           # Global styles + Tailwind
│   ├── index.html
│   ├── vite.config.js
│   ├── tailwind.config.js
│   └── package.json
│
├── start.sh             # Mac/Linux launcher
├── start.bat            # Windows launcher
└── README.md

---

✨ Features

• 🔐 JWT authentication (signup, login, protected routes)
• 😊 10-point mood scale with emoji indicators
• ⚡ Energy level & sleep tracking sliders
• 🏷️ Activity tagging (exercise, meditation, etc.)
• 📖 Private journaling with mood tags & writing prompts
• 📊 Analytics dashboard with area charts (Recharts)
• 🔥 Streak tracking
• 🌙 Dark theme with glass morphism UI
• 📱 Fully responsive (mobile + desktop)

---

🔑 API Endpoints

Method	Endpoint	Description
POST	/auth/signup	Create account
POST	/auth/login	Login (returns JWT)
GET	/auth/me	Get current user
POST	/moods	Create mood entry
GET	/moods	List mood entries
DELETE	/moods/{id}	Delete mood entry
POST	/journals	Create journal entry
GET	/journals	List journal entries
DELETE	/journals/{id}	Delete journal entry
GET	/analytics/summary	Get analytics data

---

Built with 💜 using FastAPI + React