Skip to content

README.md

Latest commit

 

History

History
250 lines (174 loc) · 5.98 KB

README.md

File metadata and controls

250 lines (174 loc) · 5.98 KB
Raw

🌈 HappyVerse: A Digital Ecosystem for Emotional Well-being & Mindfulness

🎓 Course – Happiness & Well-being (Academic Project)
👥 Team Name – CODE2AIM
💡 Project Theme – Technology for Emotional Awareness & Mental Wellness
📩 Contact Email – aditimehta307@gmail.com

🌱 A Brief of the Platform

HappyVerse is a multi-module digital well-being platform designed to help users relax, reflect, and reconnect with their emotions through interactive and intelligent tools.

The platform integrates AI conversation, mindfulness experiences, mood tracking, and engaging activities into a unified ecosystem accessible through a central dashboard.

Unlike single-purpose applications, HappyVerse focuses on holistic emotional wellness, allowing users to explore different forms of self-care — from talking to an AI companion to journaling and playing calming games.

🌿 Designed for awareness, not productivity.

🧩 Modules Overview

🤖 1. AI Chatbot – HappyBot

A conversational AI companion that provides emotional support through natural interaction.

Features

  • Emotion-aware responses
  • Supportive and empathetic communication
  • Real-time chat interaction
  • Lightweight and responsive UI

Tech

  • Groq API (LLM inference)
  • HTML, CSS, JavaScript

🔗 https://happy-verse-happy-bot.netlify.app/

🎮 2. Mini Games – Mindful Engagement

A collection of interactive browser-based games designed to refresh the mind and improve mood.

Features

  • Quick stress-relief games
  • Lightweight and accessible
  • Positive reinforcement through play

Tech

  • HTML, CSS, JavaScript

🔗 https://happy-verse-mini-games.netlify.app/

🌿 3. Calm Zone – Mindfulness & Relaxation

A dedicated space for users to slow down and practice mindfulness.

Features

  • Breathing exercises
  • Calm visual environment
  • Streak tracking & engagement logic
  • Theme customization

Tech

  • React (Vite)
  • Node.js (optional backend support)

📔 4. Calm Journal – Mood Tracking System

A journaling and mood tracking module that helps users reflect on their emotional state.

Features

  • Daily mood logging
  • Personal journaling
  • Reflection and emotional tracking

Tech

  • Python Flask
  • SQLite Database
  • HTML, CSS

🔗 https://happy-verse-calm-journal.onrender.com

🔐 5. User Authentication & Personalization

HappyVerse uses Clerk Authentication to ensure secure and personalized user experiences.

Features

  • Sign up / Sign in
  • Protected dashboard
  • User-specific experience
  • Profile management

🧭 Platform Flow

Landing Page
     │
     ▼
User Authentication (Clerk)
     │
     ▼
Dashboard (Central Hub)
     │
     ├── Calm Zone (Internal React Module)
     ├── Mini Games (External App)
     ├── Happy Bot (AI Chat App)
     └── Calm Journal (Flask App)

🎨 Design Language & Experience

Theme: Digital Calm

  • 🌌 Dark Gradient Backgrounds
  • ✨ Glassmorphism UI
  • 🌿 Soft animations and transitions
  • 🎯 Minimal distractions

Colors

  • Primary: Deep Blue / Indigo
  • Accent: Neon Mint (#00FFC3)
  • Background: Dark gradient tones

The UI is designed to feel:

  • Safe
  • Calm
  • Emotionally inviting

🧰 Tech Stack

Layer Technologies
Frontend React (Vite), HTML, CSS, JavaScript
Backend Node.js, Express, Python Flask
Authentication Clerk
AI Groq API
Database SQLite
Deployment Netlify, Render

🏗️ System Architecture

User → Landing Page → Authentication (Clerk)
        ↓
     Dashboard (React)
        ↓
 ┌───────────────┬───────────────┬───────────────┐
 │               │               │               │
Mini Games   Happy Bot     Calm Zone     Calm Journal
(Netlify)    (Netlify)     (React)       (Flask)

🌟 Novelty of the Project

  • Multi-module emotional wellness ecosystem
  • Combination of AI interaction + mindfulness tools
  • Integration of different tech stacks into one platform
  • Real-world architecture with micro-app integration
  • Focus on mental well-being instead of productivity
  • Clean UI with modern frontend practices

🚀 Key Features Implemented

Feature Description
AI Chatbot Emotional conversation support
Mini Games Mood-enhancing activities
Calm Zone Mindfulness and relaxation
Mood Tracker Emotional journaling
Dashboard Central navigation system
Authentication Secure login with Clerk
Responsive UI Works across devices

🔗 Live Modules

👥 Team Contributions

Module Contributor
AI Chatbot Ishani Jindal
Mini Games Aditi Mehta
Calm Zone Mehar Bhanwra
Mood Tracker Chirag
Integration, UI, Authentication, Dashboard Pratham Ranjan

🚀 Future Scope

  • Reward & progress system
  • AI-based emotion detection improvements
  • Personalized recommendations
  • Cross-module data integration
  • Mental health insights dashboard
  • Community support features

🌈 Why It Matters

HappyVerse creates a space where users can:

  • Express emotions freely
  • Relax and reset mentally
  • Reflect on their feelings
  • Engage in positive activities

It bridges the gap between technology and emotional well-being, making self-care accessible and interactive.

✨ “Small digital moments can create real emotional impact.”

📄 License

This project is developed for academic purposes under the Happiness & Well-being course.