A modern web application that helps users explore new cultural experiences through AI-powered recommendations and social challenges.

Zesty/
├── 📁 client/                 # Frontend (React + TypeScript)
│   ├── 📁 src/
│   │   ├── 📁 pages/         # All UI components
│   │   ├── 📁 components/     # Reusable components
│   │   ├── 📁 lib/           # API services
│   │   └── 📁 hooks/         # Custom hooks
│   ├── 📄 package.json       # Frontend dependencies
│   └── 📄 vite.config.ts     # Vite configuration
├── 📁 server/                 # Backend (Express.js)
│   ├── 📄 index.js           # API proxy (164 lines)
│   └── 📄 package.json       # Server dependencies
├── 📁 supabase/              # Database & Auth
│   └── 📁 migrations/        # Database schema
├── 📄 package.json           # Root workspace config
├── 📄 env.example            # Environment variables template
└── 📄 README.md              # This file

# Install all dependencies (client + server)
npm run install:all

# Copy environment template
cp env.example .env

# Edit with your API keys
nano .env

# Run both frontend and backend
npm run dev:full

Create a .env file in the root directory:

# Supabase Configuration
VITE_SUPABASE_URL=your_supabase_url_here
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key_here

# Qloo API Configuration
VITE_QLOO_API_KEY=your_qloo_api_key_here
VITE_QLOO_BASE_URL=https://hackathon.api.qloo.com

# Gemini API Configuration
VITE_GEMINI_API_KEY=your_gemini_api_key_here
VITE_GEMINI_API_URL=https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-pro-latest:generateContent

# Backend Configuration
VITE_BACKEND_URL=http://localhost:3001
VITE_CORS_ORIGIN=http://localhost:5173

• Sign up/in with Supabase Auth
• Email confirmation flow
• Secure session management

• Interactive taste preference collection
• Multi-step form with animations
• Cultural exposure score calculation

• Swipeable cultural challenge cards
• AI-powered recommendations
• Integration with Qloo and Gemini APIs

• Progress tracking with charts
• Cultural exposure analytics
• AI-generated insights

• Taste nemesis matching
• Social challenges
• Progress sharing

• Track completed tasks
• Rate cultural experiences
• Share achievements

• ✅ API keys secured in backend
• ✅ Rate limiting enabled
• ✅ Input sanitization
• ✅ CORS protection
• ✅ Helmet security headers
• ✅ Row Level Security (RLS)

Frontend (React) → Express Server → External APIs (Qloo, Gemini)
Frontend (React) → Supabase → Database & Auth

• Framework: React + TypeScript + Vite
• Styling: Tailwind CSS + Framer Motion
• State Management: React Context API
• Routing: React Router DOM
• UI Components: Lucide React icons

• Framework: Express.js
• Security: Helmet, CORS, Rate limiting
• API Proxy: Qloo and Gemini APIs
• Error Handling: Centralized error management

• Platform: Supabase (PostgreSQL)
• Authentication: Supabase Auth
• Security: Row Level Security (RLS)
• Real-time: Live updates

• Frontend: http://localhost:5173
• Backend API: http://localhost:3001
• Health Check: http://localhost:3001/api/health

curl http://localhost:3001/api/health

Expected response:

{
  "status": "OK",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "services": {
    "qloo": "Available",
    "gemini": "Available"
  }
}

# Kill processes on ports
lsof -ti:3001 | xargs kill -9
lsof -ti:5173 | xargs kill -9

# Reinstall all dependencies
npm run install:all

# Check if .env exists
ls -la .env

npm run dev:full

# Build frontend
npm run build

# Start server
npm run server

• Frontend: Vercel, Netlify
• Backend: Railway, Render, Heroku
• Database: Supabase

• Cultural entity search
• Recommendation insights
• Cross-domain affinity

• Content generation
• Cultural explanations
• Progress insights

• User authentication
• Data storage
• Real-time updates

• 🌙 Dark theme with gradients
• ✨ Smooth animations (Framer Motion)
• 📱 Responsive design
• 🎯 Intuitive navigation
• 🎨 Modern, attractive interface

1. Create components in client/src/components/
2. Add pages in client/src/pages/
3. Update API services in client/src/lib/
4. Add backend endpoints in server/index.js

1. Create migration in supabase/migrations/
2. Update types in client/src/lib/supabase.ts
3. Test with Supabase dashboard

MIT License - see LICENSE file for details.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

Zesty - Discover Your Cultural Horizons! 🌟