MindSpace - Mental Health Companion

MindSpace is a compassionate, web-based mental health companion designed to provide immediate support, tracking, and resources for mental wellness. It offers a safe space for users to express their feelings, track their mood, and access helpful tools without judgment.

🌟 Features

• 💬 Interactive Chat Bot: A supportive AI-simulated companion that listens and provides empathetic responses for various emotional states (Anxiety, Stress, Loneliness, etc.).
• 📊 Mood Tracker: Log your daily moods with emojis and notes. View your emotional journey with a visual history chart.
• 📝 Personal Journal: A private space to write down your thoughts and feelings. All entries are stored locally on your device.
• 🧘 Breathing Exercises: specialized tools like the "Box Breathing" exercise to help calm your mind during stressful moments.
• 📚 Educational Resources: Access to cognitive techniques (CBT), self-care tips, and guided information.
• 📞 Helpline Database: Immediate access to crisis helpline numbers and professional support contacts.

🛠️ Tech Stack

• HTML5: Semantic structure and layout.
• CSS3: Modern, responsive styling with gradients and smooth transitions.
• JavaScript (Vanilla): Core logic for the chatbot, mood tracking, and data persistence (using localStorage).

Note: This application runs entirely client-side using local storage for data persistence, ensuring your data stays on your device.

🚀 Getting Started

Follow these steps to run the project locally:

1. Clone the Repository

   git clone https://github.com/yourusername/mindspace.git

2. Navigate to the Directory

   cd mindspace

3. Launch the Application

   • Simply locate the index.html file in the folder.
   • Double-click to open it in any modern web browser (Chrome, Firefox, Edge, Safari).
   • Optional: If you have Node.js installed, you can also run the development server (though the app functions fully without it):

     npm install
     npm start

     Then visit http://localhost:3000.

📁 Project Structure

• index.html: Main application file containing the structure for all views (Chat, Mood, Resources, Journal).
• style.css: Contains all styling, animations, and responsive design rules.
• bot.js: Handles the chatbot logic, mood/journal data management, and user interactions.

🔒 Privacy

MindSpace prioritizes your privacy.

• No Data Collection: All chat history, mood logs, and journal entries are stored in your browser's localStorage.
• Offline Capable: Once loaded, the core features function without an internet connection.

🤝 Contributing

Contributions are welcome! If you have ideas for new features or improvements:

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

📄 License

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