Skip to content

Mariaakhtar0035/WheelBeats

Repository files navigation

WheelBeats

Accessible live event venue finder — helping people with mobility disabilities find and plan visits to concerts, sports, theatre, and comedy venues.

Built with Next.js, TypeScript, MongoDB, and Claude AI.


Tech Stack

Layer Choice
Framework Next.js 15 (App Router, TypeScript)
Styling Tailwind CSS
Database MongoDB (local dev) → MongoDB Atlas (production)
ODM Mongoose
Auth NextAuth.js v4
AI Anthropic Claude API
Events Ticketmaster Discovery API
Hosting Vercel

Getting Started

1. Install dependencies

npm install

2. Set up environment variables

cp .env.local.example .env.local Edit .env.local and fill in your keys.

3. Start MongoDB locally

brew services start mongodb-community # Mac net start MongoDB # Windows

4. Seed the database

npx ts-node --project tsconfig.json lib/seed.ts Admin login: admin@wheelbeats.com / admin123

5. Run the dev server

npm run dev


Key Architecture Decisions

  • MongoDB: document-shaped accessibility data, paragraph-heavy notes, flexible per-venue fields
  • Field-level _source tracking: know which fields came from website vs direct contact
  • Human-in-the-loop AI: Claude extracts, admin confirms before saving
  • Cached DB connection: prevents new Mongoose connections on every hot reload
  • Next.js API routes: colocated API reduces operational complexity at this scale

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages