MindWelth

MindWelth is your intelligent mental wellness companion — a safe space to talk, reflect, and gain a deeper understanding of yourself. Whether you're journaling your thoughts, chatting with the AI about how you're feeling, or taking quick quizzes to check in on your mental state, MindWelth supports you every step of the way — with zero judgment and full privacy.

Built with the MERN Stack and powered by Google Gemini (LLM), MindWelth is designed for students, professionals, and anyone seeking to cultivate healthier emotional habits, track their moods, and gain meaningful insights into their well-being — all in one beautifully simple app.

---

Features

• Secure & Private – All data is encrypted and stored safely.
• Mood Tracking – Log and visualize your mood over time.
• Journaling – Maintain a private digital journal to express your thoughts freely.
• Meditation Guides – Access a library of guided meditations for mindfulness.
• Analytics Dashboard – Visual insights into your emotional trends and progress.
• Mental Health Quizzes – Take friendly quizzes to screen for signs of anxiety, depression, ADHD, burnout, and more.

---

Tech Stack

Frontend

• React.js
• Tailwind CSS

Backend

• Node.js / Express
• MongoDB
• JWT Authentication

DevOps & Hosting

• Git & GitHub
• Vercel
• Heroku

---

Use Cases

• Students dealing with academic stress
• Busy professionals facing burnout
• People who struggle to open up to others
• Users curious about their mental health
• Anyone trying to build self-awareness
• Therapists and coaches recommending tools to clients

---

Setup & Installation

To run MindWelth locally, ensure you have Node.js, npm, and optionally MongoDB installed.

1. Clone the Repository

git clone https://github.com/your-username/mindwelth.git
cd mindwelth

---

2. Setup Backend

cd backend
npm install

Create a .env file in the backend/ folder and add the following:

PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
GEMINI_API_KEY=your_google_gemini_api_key

Then run the backend server:

npm run dev

Your backend will be live at http://localhost:5000.

---

3. Setup Frontend

Open a new terminal window:

cd frontend
npm install

Create a .env file in the frontend/ folder and add:

REACT_APP_API_BASE_URL=http://localhost:5000

Then run the frontend:

npm start

Visit your app at http://localhost:3000.

---

Folder Structure

mindwelth/
├── frontend/   # React app (UI)
├── backend/    # Express server (API, auth, Gemini integration)
└── README.md

---

Contributing

Contributions and feedback are welcome! Feel free to fork the repo, open issues, or submit pull requests.

Demo Video