Skip to content

COOLCODERVG/mentalhealth

Repository files navigation

🌱 MentalHealth Tracker


⚠️ This is a collaborative project. Here are my personal contributions to the MentalHealth Tracker app:

-πŸ”§ Frontend Features & Styling I contributed to building and styling several frontend components, including the mood tracking UI and parts of the journaling system using React and Tailwind CSS.CSS..

-πŸ“Š Data Visualization I helped implement and customize the Insights page using Chart.js to show mood trends over time..

-πŸ› οΈ Bug Fixes & Polish I helped debug UI inconsistencies across mobile and desktop views, and made visual polish tweaks for a cleaner experience.nce..

-πŸ§ͺ Testing & Feedback I assisted with testing key features like mood submission, journal saving, and login flow, and provided user feedback to improve the UX. UX..

-πŸ“„ Project Documentation I contributed to updating the README to reflect the latest setup instructions and project structure. A full-stack mental health tracking app where users can log moods, write journals, and visualize emotional trends over time.e.


🧠 Features

  • βœ… User Authentication (Sign Up / Log In / Log Out)
  • πŸ—•οΈ Daily Mood Tracking with emotion notes
  • πŸ““ Journaling system (create, edit, delete entries)
  • πŸ“Š Mood Insights with visual charts
  • πŸ“± Fully responsive UI (mobile & desktop)top)

πŸš€ Live Demo

πŸ”— https://mentalhealth-indol.vercel.app/

πŸ› οΈ Getting Started (Local Development)

Prerequisites

  • Node.js β‰₯ 16
  • npm or yarn

Setup Instructions

git clone https://github.com/COOLCODERVG/mentalhealth.git

cd mentalhealth
npm install      # or yarn install
npm run dev      # or yarn dev

Visit http://localhost:3000 in your browser.

⚠️ Note: This project requires an .env file for API keys and environment variables. Example:

VITE_API_KEY=your_api_key_here

Place this file in the root directory before running the app.

πŸ“ Project Structure

mentalhealth/
β”œβ”€ node_modules/       # Installed packages
β”œβ”€ public/             # Static assets
β”œβ”€ src/                # Source code (components, pages, logic)
β”œβ”€ .gitignore          # Git ignored files
β”œβ”€ eslint.config.js    # ESLint configuration
β”œβ”€ index.html          # Entry HTML
β”œβ”€ package-lock.json   # Dependency lock file
β”œβ”€ package.json        # Project metadata and scripts
β”œβ”€ README.md           # Project documentation
β”œβ”€ vite.config.js      # Vite bundler configuration
iguration

βš™οΈ Tech Stack

Frontend: React, Tailwind CSS, Chart.js Backend: Node.js, Express, MongoDB Deployment: Vercel (frontend), [your backend hosting]

🧹 Key Modules

  • Mood Tracker – Submit daily mood with emoji selector + optional note
  • Journal – Create and manage personal entries
  • Insights – Visualize your emotional trends over time
  • Authentication – Register, log in, and maintain sessions securely

βœ… Pre‐Submission Checklist

  • βœ… Core functionality complete and tested
  • πŸ“¦ Local setup under 2 minutes (npm install && npm run dev run dev)
  • 🌐 Live build running at the provided URL
  • πŸ“„ README includes instructions, features, and screenshots
  • 🧹 Visually polished and stable across devices

🧱 How to Use

  1. Create an account or log in
  2. Record how you're feeling each day
  3. Use the journal for deeper reflections
  4. View weekly/monthly emotional insights

🀝 Contributing

Contributions are welcome!

  1. Fork the repo
  2. Create a new feature branch
  3. Commit your changes
  4. Open a Pull Request

πŸ“„ License

Licensed under the MIT License