# ClassCub

> US-focused directory of kids' activities and classes (swimming, karate, dance, music, sports, arts). Organized by city, category, and age group. Each provider has a structured profile with age range in months, indoor/outdoor, lat/lng, ratings, photos. ~5,200 providers across 100+ US cities, ~24K indexable pSEO URLs. Free for parents (browse, save favorites, suggest businesses). B2B claim flow for providers (Pro/Featured tiers planned).

## Key pages

- [Home](https://classcub.com): Landing - find kids' classes near you
- [Browse all](https://classcub.com/browse): All makes / models tree (cities + categories)
- [Cities](https://classcub.com/cities): All cities with provider counts
- [Activities](https://classcub.com/activities): All 23 categories
- [Things to do with kids](https://classcub.com/things-to-do-with-kids): Broad-keyword landing
- [Toddler activities](https://classcub.com/toddler-activities): Toddler-specific landing
- [Mommy and me classes](https://classcub.com/mommy-and-me-classes): Mommy and me landing
- [Baby classes](https://classcub.com/baby-classes): Baby class landing
- [Indoor activities](https://classcub.com/indoor-activities): Indoor activities landing
- [Privacy](https://classcub.com/privacy): Privacy policy
- [Terms](https://classcub.com/terms): Terms of service

## URL patterns

- /{category} - category overview (e.g. /swimming, /karate, /piano-lessons)
- /{city} - city overview (e.g. /austin-tx, /denver-co)
- /{category}/{city} - main money pages (e.g. /swimming/austin-tx)
- /{category}/{age-group}/{city} - age-filtered (e.g. /swimming/toddlers/austin-tx)
- /things-to-do-with-kids/{city}, /toddler-activities/{city}, /mommy-and-me-classes/{city}, /baby-classes/{city}, /indoor-activities/{city} - broad-keyword + city
- /provider/{slug} - individual provider profile

## Categories covered

- Swimming, karate, dance, gymnastics, soccer, basketball, baseball
- Piano lessons, music, art, theater
- STEM, coding, chess, language
- 23 top-level categories, ~40 subcategories total

## Age groups

- Baby (0-12 months)
- Toddler (1-3 years)
- Preschool (3-5 years)
- Early elementary (5-8 years)
- Late elementary (8-11 years)
- Teens (11-16 years)

## What ClassCub is

- Local directory of kids' activities, US-only
- Hierarchy: City x Category x Age group
- Provider profiles with age range in months, indoor/outdoor, lat/lng, Google rating, photos
- Vue 3 islands (filters, map, search) on top of Hotwire SSR - fully indexable without JS
- Leaflet maps per provider and per category-city page
- Parent flow: browse free, save favorites, optional child profile for personalized age filtering
- Provider claim flow: business owners can claim and customize their listing (free), Pro/Featured tiers planned
- "Suggest a business" form for parents - admin moderates submissions
- Tracks views_count and clicks_count per provider for upsell analytics
- Sitemap auto-regenerated on every deploy (~24K URLs)
- All provider data is real and verifiable (extracted from real provider websites, not hallucinated)

## What ClassCub is NOT

- Not a Google Maps clone - has age filter in months that Google Maps does not
- Not a booking platform (no payments, no commissions, parents contact provider directly)
- Not Yelp - no parent reviews yet, structured data only
- Not a content blog - no articles, pure structured directory
- Not international - US-only by design (different countries have different schooling systems)
- Not for unsupervised teens - parent-directed activities (ages 0-16)

## Private URLs (do not index)

- https://classcub.com/dashboard, /saved, /children, /claims/* - logged-in surfaces
- https://classcub.com/admin/* - operator-only admin
- https://classcub.com/go/{slug} - tracked outbound redirects (functional, not content)

## Optional

- [Sitemap](https://classcub.com/sitemap.xml): ~24K indexable URLs
- Stack: Rails 8 + Hotwire (base) + Vue 3 islands + Leaflet + Tailwind v4 + PostgreSQL
- 5,225+ providers across 102+ US cities, 23 categories, 5 age groups