• 📋 Project Brief

  Project overview, goals, and scope

• 🎯 Product Context

  User experience and feature roadmap

• 💻 Tech Context

  Technology stack and architecture decisions

• 🏗️ System Patterns

  Design patterns and implementation details

• 📊 Active Context

  Current development status and priorities

• 📈 Progress

  Development timeline and milestones

# Clone the repository
git clone https://github.com/alchemydc/musemeter.git
# Install dependencies
npm install
# Start development server
npm run dev

• 🎵 Discover live music events in your area
• 📅 Add events to your Google Calendar
• 🔍 Search by city and state
• 🌙 Dark mode support
• 🎨 Modern UI with Tailwind CSS

# Run tests
npm test
# Run tests with coverage
npm run test:coverage
# Lint code
npm run lint
# Build for production
npm run build

1. A Vercel account
2. Vercel CLI installed: npm i -g vercel
3. A Ticketmaster API key

Set up the following environment variables in your Vercel project settings:

• API_KEY: Your Ticketmaster API key
• RADIUS: Search radius for events (default: 50)
• RADIUS_UNIT: Unit for radius (default: miles)
• DEFAULT_EVENTS_PER_PAGE: Number of events per page (default: 7)

# Login to Vercel
vercel login
# Deploy to Vercel
vercel
# Deploy to production
vercel --prod

The project uses Vercel's serverless functions to handle API requests securely. The frontend will be automatically built and deployed as a static site.

To test the serverless functions locally:

# Install Vercel CLI
npm i -g vercel
# Start development server (for serverless functions)
npx vercel dev
# Start frontend (in separate terminal)
npm run dev

MIT © 2025 MuseMeter