🎵 MoodMelody - Your Personal Music Mood Diary

Track your emotions, discover music, and relive your journey through an AI-powered mood diary

---

✨ What Makes MoodMelody Magical?

MoodMelody transforms your daily emotional journey into a beautiful symphony of self-discovery

---

🚀 Core Features

🧠 AI-Powered Emotion Detection 95% accuracy with cutting-edge AI 🎯 OpenRouter + Mistral AI - Industry-leading emotion analysis 🌍 7 Languages Supported - Global emotional understanding ⚡ Real-time Processing - Instant mood detection as you type 🎨 Confidence Scoring - Know how certain the AI is about your mood	🎵 Smart Music Curation Your emotions, your soundtrack 🎧 Spotify Integration - Millions of songs at your fingertips 🌏 Localized Recommendations - Music that speaks your language 🎭 Mood-Matched Playlists - Perfect songs for every feeling 🎯 Focused Curation - Quality over quantity, every time
📊 Beautiful Analytics Dashboard See your emotional growth in stunning visuals 📈 Interactive Charts - Watch your mood patterns unfold 🔥 Streak Tracking - Gamify your journaling journey 🎨 6-Month Trends - Long-term emotional insights 🤖 AI-Generated Reports - Deep analysis of your emotional patterns	✨ Magical User Experience Designed to delight, built to perform 🎨 Glassmorphism UI - Modern, beautiful, and intuitive 📱 PWA Ready - Install like a native app 🌙 Dark/Light Themes - Adapts to your preference ⚡ Lightning Fast - Optimized for speed and performance

---

🎭 The Emotion Journey 🌟

📝 Write Your Thoughts → 🧠 AI Analyzes Your Mood → 🎵 Get Perfect Music → 📊 Track Your Growth

Feature	What It Does	Why It's Awesome
📝 Smart Journaling	Write daily entries with automatic emotion detection	Never wonder about your mood again
🎵 Music Discovery	Get personalized songs based on detected emotions	Discover your new favorite song every day
📊 Growth Analytics	Visualize emotional patterns over time	Watch yourself grow and improve
🔥 Streak System	Maintain daily journaling habits	Turn self-care into a fun game
🌍 Global Support	7 languages with localized music	Everyone deserves emotional wellness

---

🛠️ Tech Stack

🎨 Frontend Excellence

🤖 AI & Backend Power

⚡ Performance & Tools

---

🏗️ Architecture Overview

graph TB
    A[🌐 User Interface] --> B[⚛️ Next.js 15 App Router]
    B --> C[🔐 Supabase Auth]
    B --> D[🤖 OpenRouter AI]
    B --> E[🎵 Spotify API]
    B --> F[💾 Supabase Database]
    
    C --> G[👤 Google OAuth]
    D --> H[🧠 Mistral Small 24B]
    E --> I[🎧 Music Recommendations]
    F --> J[📊 Mood Analytics]
    
    style A fill:#e1f5fe
    style B fill:#f3e5f5
    style D fill:#fff3e0
    style E fill:#e8f5e8

Loading

---

🚀 Quick Start

1. Clone the Repository

git clone https://github.com/HackStyx/MoodMelody.git
cd MoodMelody

2. Install Dependencies

npm install

3. Environment Setup

Create a .env.local file with your API keys:

# Supabase Configuration
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

# AI Emotion Detection
OPENROUTER_API_KEY=your_openrouter_api_key
HUGGINGFACE_API_KEY=your_huggingface_api_key

# Spotify Music Recommendations
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret

4. Database Setup

# Run the database schema
psql -f database/schema.sql

5. Run Development Server

npm run dev

Open http://localhost:3000 to see MoodMelody in action!

📱 Screenshots

🏠 Homepage

Beautiful landing page with feature showcase

📊 Dashboard

Mood tracking, journaling, and music recommendations

📈 Mood History

Comprehensive analytics with AI insights

👤 Profile

Personalized settings and preferences

🎯 What Makes MoodMelody Special

Dive deep into the technology and intelligence that powers your emotional journey

🧠 AI Emotion Detection The brain behind your mood tracking 🎯 95% Accuracy Guarantee 🥇 Primary Engine: OpenRouter + Mistral Small 24B 🔄 Smart Fallback: Enhanced keyword detection system 🌍 Global Support: 7 languages with native understanding 📊 Confidence Metrics: Real-time certainty scoring "From 'feeling overwhelmed' to perfect emotional insight in milliseconds"	🎵 Smart Music Curation Your emotions, transformed into the perfect soundtrack 🎧 Millions of Songs at Your Service 🎭 Emotion-First: Mood-matched musical experiences 👤 Personal Touch: Your taste + AI intelligence 🌏 Culturally Aware: Localized for authentic recommendations ⚡ Quality Focus: Maximum 3 searches for perfect results "Discover your new favorite song every single day"
📊 Beautiful Analytics Watch your emotional growth unfold 📈 Your Journey Visualized 🤖 AI Insights: GPT-powered mood analysis 📅 Trend Tracking: 6-month emotional patterns 🔥 Streak Gamification: Daily consistency rewards 💡 Growth Metrics: Track your emotional development "See patterns you never knew existed in your emotional world"	🔐 Privacy & Security Your emotions, safely protected 🛡️ Enterprise-Grade Protection 🔐 Google OAuth: Secure, trusted authentication 🔒 Encrypted Storage: Row-level security policies 🔑 API Security: Environment-protected sensitive data 📡 HTTPS Everywhere: End-to-end encryption "Your most personal thoughts deserve the highest protection"

---

🌟 The MoodMelody Difference

What Others Do	What MoodMelody Does	Why It Matters
😐 Basic mood tracking	🧠 AI-powered emotion analysis	Know exactly how you feel, not just guess
🎵 Generic playlists	🎯 Mood-matched music curation	Every song resonates with your current state
📊 Simple charts	📈 AI-generated insights	Understand patterns and triggers in your emotions
🔓 Basic security	🔐 Enterprise-grade protection	Your personal journey stays completely private

🌍 Multi-language Support

Language	Search Terms	Spotify Market	Status
🇺🇸 English	Native	US	✅ Active
🇪🇸 Spanish	Localized	ES	✅ Active
🇫🇷 French	Localized	FR	✅ Active
🇩🇪 German	Localized	DE	✅ Active
🇮🇳 Hindi	Localized	IN	✅ Active
🇨🇳 Chinese	Localized	TW	✅ Active
🇯🇵 Japanese	Localized	JP	✅ Active

🤝 Contributing

We welcome contributions! Here's how you can help:

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

📄 API Documentation

Emotion Detection API

POST /api/emotion
Content-Type: application/json

{
  "text": "I'm feeling really happy today!"
}

Response:
{
  "emotion": "joy",
  "confidence": 0.95,
  "method": "openrouter"
}

Music Recommendations API

POST /api/spotify/recommendations
Content-Type: application/json

{
  "emotion": "joy",
  "preferences": ["pop", "happy"],
  "language": "en"
}

Response:
{
  "tracks": [...],
  "searches_performed": 2
}

🔧 Configuration

Supabase Setup

1. Create a new Supabase project
2. Run the provided schema (database/schema.sql)
3. Configure authentication providers (Google OAuth)
4. Set up Row Level Security policies

API Keys Setup

• OpenRouter: Get API key from OpenRouter
• Spotify: Create app at Spotify Developer
• Hugging Face: Get token from Hugging Face

📊 Analytics & Monitoring

• 📈 Vercel Analytics: User engagement and behavior tracking
• ⚡ Speed Insights: Performance monitoring and Core Web Vitals
• 🔍 Error Tracking: Comprehensive error handling and logging
• 📱 PWA Metrics: Installation and usage statistics

📞 Support

• 🌐 Live Demo: mood-melody-app.vercel.app
• 📧 Email: [Contact HackStyx](mailto: [email protected])
• 🐙 GitHub: Open an Issue
• 🐦 Twitter: @hackstyx

📜 License

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

---

Made with ❤️ by HackStyx

MoodMelody - Where emotions meet music 🎵