Project Setup Guide

This README will guide you through the steps to run this project locally. The project consists of three main components: a Python-based AI/ML microservice, a Node.js backend, and a frontend built with Vite.

📁 Project Structure

.
├── ml/                # Python-based AI/ML microservice
├── public/            # Frontend public assets
├── server/            # Backend (Node.js + Express)
├── src/               # Frontend source code (if used by Vite)
├── .env               # Environment variables
├── package.json       # Frontend dependencies
├── vite.config.js     # Vite configuration
└── README.md          # You're reading it!

git clone <repository-url>
cd <repository-directory>

cd <project-directory>

npm install

npm run dev

cd server

npm install

npm start
cd ml

python -m venv venv
venv\Scripts\activate
source venv/bin/activate

pip install -r requirements.txt

python app.py

# 🧠⚡💎 The Gauntlet of Well-Being 💎⚡🧠

A gamified wellness platform inspired by the Infinity Stones concept, designed to solve user engagement challenges in health and wellness apps.

## 🌟 Core Concept

Transform your wellness journey into an epic quest to master the Five Wellness Gems:

- **🧠 Mind Gem** - Mental Clarity & Focus
- **💪 Body Gem** - Physical Health & Energy  
- **❤️ Soul Gem** - Social & Emotional Connection
- **💰 Wealth Gem** - Financial Wellness & Planning
- **🎯 Purpose Gem** - Personal Growth & Purpose

## 🎮 Key Features

### ✨ Interconnectivity System
The revolutionary feature that sets this apart - gems affect each other:
- Neglecting physical activity drains mental clarity
- Lack of social connection weakens physical energy
- Missing purpose affects financial focus
- Soul Gem acts as the foundation affecting all others

### 🎯 Gamification Elements
- **Visual States**: Bright (powered), Dim (inactive), Draining (interconnected effects)
- **Quest System**: Complete daily challenges to power up gems
- **Balance Meter**: Track overall wellness progress
- **Status Messages**: Real-time feedback on gem interactions

### 🧠 Behavioral Psychology Integration
- **Habit Formation**: Small daily actions with immediate rewards
- **Loss Aversion**: Fear of losing progress motivates maintenance
- **Social Accountability**: Soul Gem encourages community engagement
- **Holistic Balance**: Interconnectivity teaches real wellness principles



 **Open Browser**
   Navigate to `http://localhost:5173`

## 🎯 Demo Flow

1. **Initial State**: Mind Gem is bright, others are dim (20% balance)
2. **Complete Quests**: Click quest buttons to power up gems
3. **Watch Balance**: Balance meter increases with each powered gem
4. **Simulate Decay**: Click "Daily Decay" to see interconnectivity effects
5. **Observe Messages**: Status messages explain gem interactions
6. **Reset**: Use reset button to start over

## 🏆 Hackathon Submission

### MVP Deliverables ✅
- ✅ **Core Gamification Engine**: Quest system with gem states
- ✅ **UI Mockups**: High-fidelity interactive prototype
- ✅ **Technical Architecture**: React-based frontend with state management
- ✅ **User Journey Maps**: Complete quest → power gem → maintain balance flow
- ✅ **Metrics Dashboard**: Balance meter and status tracking

### Advanced Features ✅
- ✅ **Working Prototype**: Fully functional interactive demo
- ✅ **Behavioral Psychology**: Interconnectivity system based on wellness science
- ✅ **Social Features**: Soul Gem encourages community engagement
- ✅ **Business Model**: Increases DAU/MAU through engagement mechanics

## 🎨 Technical Stack

- **Frontend**: React 18 with Vite
- **Styling**: CSS3 with animations and gradients
- **State Management**: React Hooks (useState, useEffect)
- **Responsive Design**: Mobile-first approach

## 🌟 Innovation Tracks Addressed

### Track 1: Behavioral Psychology ✅
- Habit formation through small rewards
- Loss aversion through decay mechanics
- Social accountability via Soul Gem
- Cognitive reframing of wellness tasks

### Track 2: Emerging Technology ✅
- Interactive visual feedback system
- Real-time state management
- Responsive design for all devices

### Track 3: Social Impact ✅
- Community wellness through Soul Gem
- Holistic approach to health and wealth
- Educational interconnectivity system

## 🎯 Business Impact

### User Engagement Solutions
- **Feature Discovery**: Quest system guides users to explore all app features
- **Motivation Maintenance**: Interconnectivity prevents routine boredom
- **Social Interaction**: Soul Gem creates community engagement opportunities

### Metrics Improvement
- **DAU/MAU**: Daily quest completion increases daily active users
- **Feature Usage**: Quest system drives exploration of all wellness areas
- **Retention**: Interconnectivity creates ongoing engagement loops

## 🚀 Future Enhancements

- **Firebase Integration**: Real user accounts and data persistence
- **AI Personalization**: ML-powered quest recommendations
- **Wearable Integration**: Connect with fitness trackers and health apps
- **Social Features**: Team challenges and leaderboards
- **Insurance Integration**: Connect with YouMatter's policy servicing features

---

**Built for Star Union Dai-ichi Life Insurance Hackathon**  
*Solving engagement challenges through gamification and behavioral psychology*