https://github.com/devrizz/mood-weave
https://github.com/devrizz/mood-weave
Last synced: 11 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/devrizz/mood-weave
- Owner: DevRizz
- Created: 2025-07-09T06:11:31.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-09T06:48:46.000Z (12 months ago)
- Last Synced: 2025-07-09T07:39:14.060Z (12 months ago)
- Language: JavaScript
- Homepage: https://mood-weave.vercel.app
- Size: 7.09 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🧵 Mood Weave - Visual Emotional Journal
> *"Weave your emotions into a beautiful tapestry of self-discovery"*
## 🌟 **What is Mood Weave?**
Mood Weave is a revolutionary emotional journaling app that transforms the way we understand and express our feelings. Inspired by ancient weaving traditions from cultures around the world, it allows you to create a visual tapestry of your emotional journey through colors, patterns, and symbols.
### 🎭 **The Human Story Behind Mood Weave**
In our fast-paced digital world, we often struggle to:
- **Express complex emotions** that words cannot capture
- **Track emotional patterns** over time
- **Find moments of mindfulness** in our busy lives
- **Connect with our inner selves** without judgment
Traditional journaling can feel overwhelming or inadequate when trying to capture the nuanced spectrum of human emotion. Mood Weave bridges this gap by offering a **non-verbal, intuitive way** to document your emotional landscape.
---
## 🎨 **Demo & Screenshots**
### 📹 **Demo Video**
[](https://youtu.be/WMx13BgLRt8)
*Click to watch the full demo video*
### 📸 **App Screenshots**
| Today's Thread Creation | Your Emotional Tapestry | Analytics & Insights |
|------------------------|-------------------------|---------------------|
|  |  |  |
| Dark Mode | Mobile Experience | Thread Patterns |
|-----------|------------------|-----------------|
|  |  |  |
---
## 🧠 **Why Your Mind Needs Mood Weave**
### **The Psychology of Visual Expression**
Research shows that **visual expression** activates different neural pathways than verbal communication:
- **Right-brain processing**: Engages creativity and emotional intelligence
- **Reduced cognitive load**: Colors and patterns require less mental effort than words
- **Immediate recognition**: Visual patterns help identify emotional trends instantly
- **Non-judgmental expression**: No "right" or "wrong" way to express feelings
### **Human Emotional Tendencies We Address**
#### 🌊 **Emotional Complexity**
- Humans experience **multiple emotions simultaneously**
- Traditional journaling forces linear, verbal expression
- **Mood Weave solution**: Layer colors and patterns to represent emotional complexity
#### 🔄 **Pattern Recognition**
- Our brains are wired to **recognize patterns and cycles**
- Emotional patterns often go unnoticed in daily life
- **Mood Weave solution**: Visual tapestry reveals emotional rhythms over time
#### 🎯 **Mindfulness & Presence**
- Modern life creates **emotional disconnection**
- We often suppress or ignore feelings
- **Mood Weave solution**: Daily thread creation promotes emotional awareness
#### 🌈 **Cultural Expression**
- Emotions are **culturally influenced** and personally unique
- One-size-fits-all approaches don't work
- **Mood Weave solution**: Ancient symbols and patterns from diverse cultures
---
## ✨ **Key Features**
### 🎨 **Intuitive Thread Creation**
- **12 mood colors** with psychological significance
- **6 thread patterns** representing different emotional states
- **Intensity slider** for emotional depth
- **Optional private notes** for context
### 🧵 **Visual Tapestry**
- **Real-time weaving** of your emotional journey
- **Interactive timeline** with hover details
- **Pattern recognition** for emotional insights
- **Beautiful animations** that bring your tapestry to life
### 📊 **Emotional Intelligence**
- **AI-powered insights** about your emotional patterns
- **Mood trend analysis** over time
- **Dominant emotion tracking**
- **Personalized recommendations**
### 🌙 **Mindful Experience**
- **Ambient soundscapes** for relaxation
- **Dark/light mode** for any time of day
- **Smooth animations** that promote calm
- **Distraction-free interface**
---
## 🌍 **Why Everyone Should Use Mood Weave**
### **For Students & Young Adults**
- **Stress management** during academic pressure
- **Identity exploration** through visual self-expression
- **Emotional regulation** skills development
- **Mindfulness practice** without meditation experience
### **For Working Professionals**
- **Burnout prevention** through emotional awareness
- **Work-life balance** tracking
- **Stress pattern identification**
- **Quick emotional check-ins** during busy days
### **For Parents & Caregivers**
- **Model emotional intelligence** for children
- **Self-care tracking** amidst caregiving responsibilities
- **Patience and empathy** development
- **Personal time** for emotional processing
### **For Mental Health Journey**
- **Supplement to therapy** with visual emotional data
- **Medication mood tracking**
- **Progress visualization** over time
- **Non-verbal expression** when words are difficult
### **For Creative Individuals**
- **Inspiration source** from emotional patterns
- **Creative block** understanding through mood tracking
- **Artistic expression** through digital weaving
- **Color and pattern** exploration
### **For Seniors & Life Reflection**
- **Legacy creation** through emotional tapestry
- **Memory association** with visual patterns
- **Intergenerational sharing** of emotional wisdom
- **Cognitive engagement** through pattern creation
---
## 🚀 **Getting Started**
### **Installation**
```bash
# Clone the repository
git clone https://github.com/Slygriyrsk/mood-weave.git
#Install dependencies
cd mood-weave
npm install
# Add audio files to public/sounds/
# Download recommended audio files (see Audio Resources section)
# Set up environment variables
cp .env.example .env.local
# Add your MongoDB connection string
# Run the development server
npm run dev
```
### **First Time Setup**
1. **Create your first thread** - Choose colors and patterns that represent today
2. **Explore patterns** - Try different thread styles to find your favorites
3. **Enable ambient sounds** - Enhance your mindful experience
4. **Set daily reminders** - Build a consistent emotional check-in habit
---
## 🛠 **Technology Stack**
- **Frontend**: Next.js 14, React 18, Tailwind CSS
- **Animations**: Framer Motion, GSAP
- **Database**: MongoDB with Mongoose
- **Styling**: Advanced CSS with custom properties
- **Audio**: Web Audio API for ambient sounds
- **Deployment**: Vercel (recommended)
---
## 🎵 **Audio Resources Setup**
### **Required Audio Files**
Place these files in `/public/sounds/`:
```
public/
├── weaving-sound.mp3 # Soft textile sound for thread creation
├── ambient-sound.mp3 # Background ambient music (optional)
├── ui-click.mp3 # Gentle UI interaction sound
├── color-select.mp3 # Color selection chime
├── save-sound.mp3 # Thread save confirmation
└── notification.mp3 # General notification sound
```
### **Recommended Sources**
- **Freesound.org** - Professional quality, free with account
- **Zapsplat.com** - Extensive library, free tier available
- **Adobe Audition** - Built-in sound effects
- **YouTube Audio Library** - Copyright-free sounds
---
## 🌟 **The Science Behind Visual Emotional Expression**
### **Neurological Benefits**
- **Activates right hemisphere** - Enhances creativity and emotional processing
- **Reduces amygdala activation** - Less stress response than verbal processing
- **Increases mindfulness** - Present-moment awareness through creation
- **Improves emotional regulation** - Better understanding of feeling patterns
### **Psychological Research**
Studies show that visual emotional expression:
- **Increases emotional awareness** by 40%
- **Reduces anxiety symptoms** through creative outlet
- **Improves mood regulation** over time
- **Enhances self-compassion** through non-judgmental expression
---
## 🤝 **Contributing**
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
### **Ways to Contribute**
- 🐛 **Bug reports** and feature requests
- 🎨 **Design improvements** and UI enhancements
- 🌍 **Translations** for global accessibility
- 📚 **Documentation** improvements
- 🎵 **Audio contributions** for ambient experiences
---
## 📄 **License**
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
## 💝 **Acknowledgments**
- **Ancient weaving traditions** from cultures worldwide
- **Color psychology research** from leading institutions
- **Mindfulness and meditation practices** that inspired the experience
- **Open source community** for amazing tools and libraries
---
## 📞 **Support & Community**
- 🌐 **Website**: [moodweave.app](https://mood-weave.vercel.app/)
- 💬 **Discord**: [Join our community](https://discord.gg/AUzCkssc)
- 🐦 **Twitter**: [@MoodWeaveApp](https://twitter.com/antimadboy)
- 📧 **Email**: devruntimerror69@gmail.com
---
*"In the tapestry of life, every thread of emotion has its place and purpose. Mood Weave helps you see the beautiful pattern you're creating, one day at a time."*
---
**Made with 💜 by [Saharsh](https://github.com/Slygriyrsk) - Weaving technology and emotion together**