# ProSwing - Agent Documentation

> AI baseball swing analyzer. Browser-based, 100% private, runs locally.

## Site Overview

- **URL**: https://proswing.net
- **Type**: Web application (SPA with server-rendered pages)
- **Framework**: Next.js 16, React 19, TypeScript
- **Purpose**: Free biomechanical baseball/softball swing analysis using AI computer vision

## Routes

| Route | Description | Rendering |
|-------|-------------|-----------|
| `/` | Main app — upload/processing/studio/live-studio flow | Client-side (SPA) |
| `/blog/science-of-perfect-baseball-swing` | Blog post on swing biomechanics | Server-rendered |

## Static Assets

| Path | Description |
|------|-------------|
| `/sitemap.xml` | XML sitemap (auto-generated) |
| `/robots.txt` | Robots directives |
| `/llms.txt` | LLM-friendly site description |
| `/agents.md` | This file — agent documentation |
| `/site.webmanifest` | PWA manifest |
| `/proswing-icon.png` | OpenGraph / social share image |

## Structured Data (JSON-LD)

The root layout includes two JSON-LD schemas:

1. **SoftwareApplication** — Describes the app as a SportsApplication with feature list, pricing (free), and platform info
2. **HowTo** — 4-step guide for using the swing analyzer

## SEO Metadata

- **Title**: ProSwing - Elite Hitting Analytics for Every Level
- **Description**: Turn any phone or webcam into a swing analysis lab. No sensors. No expensive hardware. 100% local and private.
- **Keywords**: baseball swing analysis app, AI baseball hitting coach, pitch swing synchronization software, free mobile baseball video analysis, optimize swing mechanics, hitting analytics, webcam swing analysis, no sensors swing analysis, local private AI, compare swing MLB, biomechanical analysis
- **OpenGraph**: Website type, summary_large_image card, 1200x630 image
- **Theme Color**: #CE1141

## Content Summary

### Home Page (SPA)
Single-page application with four phases:
1. **Upload** — Drag-and-drop or select video files
2. **Processing** — MediaPipe pose detection runs in-browser
3. **Studio** — View analysis results with charts and metrics
4. **Live Studio** — Real-time webcam analysis with skeleton overlay

### Blog Post
Long-form article covering:
- Baseball swing biomechanics phases (load, stride, rotation, contact, follow-through)
- Kinematic sequence analysis
- Hip-shoulder separation mechanics
- Statistical comparison to MLB averages
- Driveline hitting philosophy

## Crawl Guidelines

- Sitemap available at `/sitemap.xml`
- The home page is a client-side SPA; crawlers should index the server-rendered shell
- Blog content is fully server-rendered and SEO-optimized
- All static assets are in `/public/`
- No authentication required
- No paywalls
- Content is safe for all audiences (sports/fitness)

## API Endpoints

None. All processing is client-side. No server-side data collection.

## Privacy

- 100% client-side processing — no video data leaves the browser
- No user accounts or authentication
- Analytics uses Google Tag Manager with consent gating (default: denied)
- Cookie consent banner required before analytics activation