# Warp Speed Fit - Site Information for LLMs

## Site Overview
Warp Speed Fit is a fitness service landing page targeting engineers, developers, and tech professionals. The service offers 20-minute High Intensity Training (HIT) workouts designed for people who work at computers and want efficient, effective fitness without changing clothes.

**Tagline:** "The Nerds' Paradise" - The best workout of your life in 20 minutes or less.

**Target Audience:**
1. Engineers, developers, and tech professionals who spend their lives in front of a computer.
2. People on GLP-1 medications (tirzepatide, semaglutide) who want to retain muscle and bone while losing fat — the muscle-retention / body-recomposition audience.

## Core Value Propositions

1. **20 Minutes** - Maximum efficiency workouts
2. **HIT Technology** - High Intensity Training machines that adjust to your strength in real-time
3. **No Changing Clothes** - Come straight from your desk
4. **1-2x per week** - Minimal time commitment for maximum results

## Site Structure

### Main Landing Page (`/`)
The homepage contains several sections:

1. **Hero Section**
   - Title: "Warp Speed Fit"
   - Subtitle: "The best workout of your life in 20 minutes or less"
   - Key features: 20 min sessions, 1-2x per week, No changing clothes, HIT Technology
   - Primary CTA: "Commit to Beta: $99" (scrolls to checkout)

2. **GLP-1 / Muscle Retention Section** (`#glp1`)
   - Headline: "Losing weight. Keep the muscle."
   - Problem framed: up to ~40% of weight lost on a GLP-1 can be lean mass (muscle + bone); one weekly High Intensity Training session preserves it
   - Founder's own recomposition results (4 months tirzepatide, 2 workouts/week, 20 min each): −20+ lbs fat, +4 lbs lean muscle, 40 min/week total
   - Two-session protocol: Tuesday = Eccentric Only (muscle-retention priority), Friday = Concentric Only (strength/power)
   - CTA: "Protect Your Muscle: Commit to Beta →"
   - Includes a not-medical-advice disclaimer

3. **Performance Tracking Section**
   - Three data visualizations:
     - Strength Progression (12-week strength gains tracking)
     - Power Output (Muscle group power analysis)
     - Session Metrics (Duration and intensity over time)
   - Uses Recharts library for visualization

4. **Features Section**
   - Three feature cards highlighting:
     - ⚡ 20 Minutes
     - 🤖 HIT Technology
     - 💻 No Changing Clothes

5. **Slack Integration Teaser**
   - Upcoming feature: Slack integration for workout reminders and tracking
   - Shows mock Slack messages demonstrating:
     - Workout reminders (`/warp-speed-book`)
     - Session stats (`/warp-speed-stats`)
     - Weekly summaries

6. **Leaderboard Section**
   - Gamification element showing user rankings
   - Three leaderboard types:
     - **Most Consistent**: Weeks with workouts (last 12 weeks)
     - **Highest Output Per Workout**: Peak power output in a single workout
     - **Highest Output Per Movement**: Peak power output for a single movement
   - Displays user handles, rankings, and metrics
   - Tabbed interface to switch between leaderboard types
   - CTA: "Join the Competition"

7. **Checkout Section** (`#waitlist` - kept for anchor compatibility)
   - Title: "Commit to Beta: Secure Your Founder's Pack"
   - Description: "$99 commitment pre-purchases 3-session 'Data-Dive' intro pack. Limited to first 50 Founders."
   - Form fields:
     - Email (required)
     - Name (required)
     - Company (required, dropdown): Oracle, Broadcom, Alteryx, Sierra Space, Ball Corporation, Stanley Consultants, Conga, Kimley-Horn, Webroot, Gogo Business Aviation, Other
     - Location (required, dropdown): Interlocken Business Park, Arista, Broomfield (Other), Remote / Not in Broomfield
     - Discount Code (optional) - e.g., "FOUNDER" for 20% off
   - Payment: $99 via Stripe Checkout
   - Form submission via POST to `/api/checkout` (creates Stripe checkout session)

8. **Footer**
   - Simple tagline: "Warp Speed Fit — Built for engineers, by engineers"

### API Endpoints

#### POST `/api/checkout`
- Accepts: `{ email, name, company, location, discountCode?, amount }`
- Validates email format and required fields
- Applies discount codes (e.g., "FOUNDER" = 20% off)
- Creates Stripe checkout session for Founder's Pack ($99, or discounted amount)
- Stores checkout attempt in Supabase `waitlist` table (for tracking)
- Returns: `{ sessionId, url }` - redirects user to Stripe Checkout
- On success, user is redirected to `/checkout/success`

#### GET `/api/content` (AI-friendly content endpoint)
- Returns structured JSON with all site content
- Includes metadata, sections, features, and API information
- **Recommended for AI consumption** - Use this endpoint to get all site information in a structured format
- Response includes: hero content, features, performance metrics, checkout info, API endpoints, and design guidelines
- Cached for performance (1 hour cache, 24 hour stale-while-revalidate)

#### GET `/api/leaderboard`
- Returns leaderboard rankings for gamification
- **PRIVACY**: Only exposes public handles and names. Never exposes emails or internal IDs.
- Query parameters:
  - `type`: `'consistency' | 'workout-output' | 'movement-output' | 'all'` (default: `'all'`)
  - `limit`: Number of results (default: 10, max: 100)
- Response includes:
  - `consistency`: Array of users ranked by weeks with workouts
  - `workoutOutput`: Array of users ranked by highest single workout output
  - `movementOutput`: Array of users ranked by highest single movement output
  - `generatedAt`: ISO timestamp of when data was generated
- Each entry includes: `rank`, `handle` (public), `name` (public), `value`, `totalWorkouts`, `lastWorkout`
- **Never includes**: `email`, `id`, `user_id`, or any other private identifiers
- Cached for performance (5 minute cache, 10 minute stale-while-revalidate)

## Technical Stack

- **Framework:** Next.js 16 (App Router)
- **Language:** TypeScript
- **Styling:** Tailwind CSS
- **UI Components:** ShadCN UI
- **Charts:** Recharts
- **Database:** Supabase (PostgreSQL)
- **Form Validation:** React Hook Form + Zod
- **Fonts:** Geist Sans, Geist Mono

## Design Philosophy

- **Dark mode** by default (perfect for developers)
- **Monospace fonts** throughout (tech aesthetic)
- **Developer-friendly language** - "Commit to Beta" instead of "Sign Up", "Deploy to Production" terminology
- **Data-driven** - "If you can't measure it, you can't improve it"
- **Minimalist** - Clean, focused design

## Database Schema

### `waitlist` table
- `id` (UUID, primary key)
- `email` (TEXT, unique, required)
- `name` (TEXT, optional)
- `role` (TEXT, optional)
- `company` (TEXT, optional)
- `city` (TEXT, auto-detected from IP)
- `state` (TEXT, auto-detected from IP)
- `country` (TEXT, auto-detected from IP)
- `ip_address` (TEXT)
- `user_provided_location` (TEXT, optional)
- `created_at` (TIMESTAMP)

### `users` table (for leaderboard)
**PRIVACY MODEL**: Strict separation between private identifiers and public handles
- `id` (UUID, primary key) - **PRIVATE**: Internal identifier, never exposed in public APIs
- `email` (TEXT, unique, required) - **PRIVATE**: Used for authentication only, never exposed in public APIs
- `handle` (TEXT, unique, required) - **PUBLIC**: Gamification username shown on leaderboard (only public identifier)
- `name` (TEXT, optional) - **PUBLIC**: Display name (optional, can be null)
- `role` (TEXT, optional) - **PRIVATE**: Not exposed in leaderboard
- `company` (TEXT, optional) - **PRIVATE**: Not exposed in leaderboard
- `created_at` (TIMESTAMP)
- `updated_at` (TIMESTAMP)

**Anonymity**: Users can change their handle to maintain anonymity. The handle is the only identifier exposed in leaderboards. Email and internal IDs are never exposed.

### `workouts` table
- `id` (UUID, primary key)
- `user_id` (UUID, foreign key to users)
- `workout_date` (TIMESTAMP, required)
- `total_output` (DECIMAL, required) - Total power output for workout
- `duration_minutes` (INTEGER, required)
- `intensity_score` (DECIMAL, optional)
- `created_at` (TIMESTAMP)

### `movements` table
- `id` (UUID, primary key)
- `name` (TEXT, unique, required) - e.g., "Chest Press", "Leg Press"
- `muscle_group` (TEXT, optional)
- `description` (TEXT, optional)

### `workout_movements` table
- `id` (UUID, primary key)
- `workout_id` (UUID, foreign key to workouts)
- `movement_id` (UUID, foreign key to movements)
- `output` (DECIMAL, required) - Power output for this movement
- `sets` (INTEGER, optional)
- `reps` (INTEGER, optional)
- `weight_resistance` (DECIMAL, optional) - HIT resistance level
- `created_at` (TIMESTAMP)

### Views
- `weekly_workouts` - Aggregates workouts by user and week
- `leaderboard_metrics` - Pre-computed leaderboard metrics for performance

## Key Components

### Charts
- `StrengthProgressionChart` - 12-week strength tracking
- `PowerOutputChart` - Muscle group analysis
- `SessionMetricsChart` - Duration and intensity

### UI Elements
- `FloatingTerminal` - Terminal-style floating element
- `FloatingCTA` - Floating call-to-action button
- `ScrollToWaitlistButton` - Button that scrolls to checkout section (kept name for compatibility)
- `CheckoutForm` - Main checkout form with Stripe integration

## Future Features

- **Slack Integration** (coming soon)
  - Workout reminders
  - Session tracking
  - Stats commands (`/warp-speed-stats`)
  - Booking commands (`/warp-speed-book`)

## Content Guidelines for AI

When generating or modifying content:
1. Maintain the "nerd/developer" tone and language
2. Use technical metaphors (deploy, production, etc.)
3. Emphasize efficiency and data-driven approach
4. Keep messaging concise and direct
5. Use monospace fonts for code-like elements
6. Maintain dark mode aesthetic

## Site URLs

- Production: https://warpspeedfit.com (when deployed)
- Local Development: http://localhost:3000
- API Base: `/api`
- Content API: `/api/content` (structured JSON for AI consumption)
- LLMs.txt: `/llms.txt` (this file)

## Contact & Support

- Checkout for Founder's Pack ($99) available on homepage
- Payment processing via Stripe Checkout
- Limited to first 50 Founders

---

Last Updated: 2024
Version: 0.1.0