🏋️ FitPass — AI Class Booking SaaS Platform

---

🏃 One Membership. Thousands of Classes. Unlimited Possibilities.

FitPass is an AI-powered fitness class booking platform that gives users access to yoga studios, HIIT gyms, cycling centers, boxing clubs, and more — all through a single subscription. Discover classes near you, book instantly, and let AI guide your fitness journey.

---

🎯 Who Is This For?

Perfect for:

• Gym-hoppers who want variety
• Travelers who need workouts anywhere
• Anyone exploring new fitness routines

---

⚡ What Makes It Different?

• 🤖 AI-Powered Discovery — Personalized class recommendations
• 📍 Location-First Search — Radius-based class filtering
• 🎟️ Tier-Based Access — Basic, Performance, Champion
• 🆓 3-Day Free Trial — No commitment

---

🛠️ Technical Highlights

• Next.js App Router + Server Actions
• Clerk authentication + subscription billing
• Sanity CMS with real-time SDK React
• Vercel AI Gateway + AI SDK 6.0 (ToolLoopAgent)
• Geographic filtering (Bounding Box + Haversine)
• Leaflet maps + Mapbox autocomplete
• Zustand state management
• TypeScript + Zod validation

---

🤔 What Is This App?

Think of FitPass as your personal fitness passport.
Instead of being locked into a single gym, you gain access to a network of venues — all managed through one intelligent platform.

How It Works

1. Sign up and choose a plan
2. Set your location and travel radius
3. Browse nearby classes
4. Book instantly
5. Confirm attendance

---

💳 Subscription Tiers

Tier	Price	Classes	Access
Basic	$29/mo	5	Basic classes
Performance	$59/mo	12	Basic + Performance
Champion	$99/mo	Unlimited	All classes

All plans include a 3-day free trial.

---

✨ Features

For Fitness Enthusiasts

• 📍 Location-based discovery
• 🤖 AI fitness assistant
• 🗺️ Interactive maps
• 📅 Instant booking
• ✅ Attendance confirmation

Technical Features

• ⚡ Real-time CMS updates
• 🔐 Subscription-aware access control
• 🧠 AI SDK ToolLoopAgent
• 📱 Mobile-responsive UI

---

🖼️ Screenshots

Home	Features

Classes	Pricing

Map View	My Bookings

Checkout	AI Fitness Assistant

Authentication

---

🏁 Getting Started

Prerequisites

• Node.js 18+
• pnpm
• Clerk account
• Sanity account
• Mapbox account
• Vercel AI Gateway access

---

🚀 Step-by-Step Setup

1. Clone the Repository

git clone https://github.com/johnsonr84/ai-class-booking-saas-platform
cd ai-class-booking-saas-platform

2. Install Dependencies

pnpm install

3. Environment Variables

cp .env.example .env.local

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=

NEXT_PUBLIC_SANITY_PROJECT_ID=
NEXT_PUBLIC_SANITY_DATASET=
NEXT_PUBLIC_SANITY_API_VERSION=
SANITY_API_TOKEN=

NEXT_PUBLIC_MAPBOX_ACCESS_TOKEN=

AI_GATEWAY_API_KEY=

⚠️ Never commit .env.local.

---

4. Configure Services

• Clerk: Create 3 billing tiers + enable trials
• Sanity: Create project + dataset
• Mapbox: Enable autocomplete
• Vercel: Create AI Gateway key

---

5. Import Data & Generate Types

npx sanity dataset import sample-data.ndjson production
pnpm typegen

6. Run Locally

pnpm dev

• App: http://localhost:3000
• Studio: http://localhost:3000/studio
• Admin: http://localhost:3000/admin

---

🚀 Deployment

1. Push to GitHub
2. Import repo into Vercel
3. Add environment variables
4. Deploy

Post-deploy:

• Update Clerk allowed origins
• Configure Sanity CORS
• Test booking flow

---

👨‍💻 Author

Robert Johnson
Full-Stack Software Engineer
🌐 https://robertjohnsonportfolio.com