Mood Map

MoodMap is an AI-powered mood journal that helps students uncover emotional patterns, understand triggers, and build healthier habits through personalized insights and guidance. 🧠✨

Comment

MoodMap X: The World's First Living Emotional Ecosystem

💡 Inspiration

Mental health tracking apps today are clinically sterile, highly unengaging, and often feel like administrative tasks. When users are emotionally vulnerable, filling out rigid forms and analyzing line charts is the last thing they want to do. We saw high abandonment rates—often within 14 days—because traditional journaling lacks immediate emotional reciprocity. Furthermore, most platforms are purely reactive; they track what has already happened, but fail to predict when a user might enter a period of severe burnout. We wanted to build something proactive, personalized, and alive.

⚙️ What it does

MoodMap X completely reimagines emotional wellness software. Instead of a static dashboard, users step into a dynamic, living ecosystem that changes color, atmosphere, and interactions based on their real-time emotional state.

  • Living Ecosystem UI: Happy states trigger bright colors and floating particles, while anxious states create soothing, grounded color palettes to encourage calm.
  • Proactive ML Prediction: It analyzes historical mood data, energy levels, and sleep patterns to predict burnout before it happens, offering a risk percentage and contextual advice.
  • AI Companions: Users are paired with context-aware virtual pets (e.g., Fox, Panda) that provide empathetic, conversational interactions tailored to their current mood.
  • SOS Shield: A geolocation-enabled emergency protocol connecting users to local crisis hotlines instantly.
  • Immersive Journaling & Gamification: NLP-driven journaling that identifies cognitive distortions, coupled with XP and unlockables to encourage consistent habit-building.

🛠️ How we built it

We architected MoodMap X using a highly scalable, decoupled microservices approach:

  • Frontend: A beautifully responsive Single Page Application built with React 18, TypeScript, Tailwind CSS, and Vite.
  • Core API: A Node.js/Express backend managing JWT authentication, secure routing, and database transactions with a PostgreSQL database.
  • AI/ML Service: A dedicated Python FastAPI microservice running Scikit-Learn Random Forest classifiers. This isolates heavy ML inference (burnout prediction) from the core I/O operations.
  • Deployment: The entire stack is containerized using Docker and orchestrated via Docker Compose, making it cloud-ready for AWS or Vercel.

🚧 Challenges we ran into

One of our biggest hurdles was designing an architecture that could handle real-time, dynamic UI updates alongside heavy machine learning inference without causing bottlenecks or lag. We solved this by strictly separating concerns: the Node API acts as a gateway while the lightweight FastAPI server handles the heavy lifting, achieving ML inference latencies of ~45ms.

Additionally, handling sensitive user health data (PHI) meant we had to rigorously prioritize security, implementing stateless JWTs, AES-256 encryption at rest, and strict input validation.

🏆 Accomplishments that we're proud of

We are incredibly proud of the "Living Ecosystem" interface. Watching the app physically react, morph, and comfort a user based on their mood is a magical experience that standard dashboards simply cannot provide. Furthermore, our burnout prediction model achieved an 89.4% accuracy rate on our holdout test sets. Successfully bridging React, Node, PostgreSQL, and FastAPI into a unified, production-ready Docker network was a massive technical win.

📚 What we learned

We vastly deepened our understanding of microservices architecture and cross-service communication. We learned how to efficiently serve Machine Learning models in a production environment using FastAPI and Uvicorn. Most importantly, we learned the profound impact that empathetic UI/UX design can have on mental health technology.

🚀 What's next for MoodMap X

We are just getting started! Our immediate roadmap includes:

  1. Wearable Integration: Syncing Apple Watch HR/HRV data to add physiological metrics to our burnout prediction model.
  2. Voice-to-Text Journaling: Integrating the Whisper API to allow users to brain-dump their feelings without typing.
  3. Enterprise Tier: Building corporate wellness dashboards to help companies tackle the $1 Trillion global cost of decreased productivity due to burnout.
Share this project:

Updates