MuseMeter

Because if the question is "live music" the answer is always "yes" :)

📖 Documentation

• 📋 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

🚀 Getting Started

# Clone the repository
git clone https://github.com/alchemydc/musemeter.git

# Install dependencies
npm install

# Start development server
npm run dev

✨ Features

• 🎵 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

🧪 Development

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint code
npm run lint

# Build for production
npm run build

🚀 Deployment

Prerequisites

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

Environment Variables

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)

Deploy to Vercel

# 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.

Local Development

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

📝 License

MIT © 2025 MuseMeter