# LLMs.txt — Instructions for AI Crawlers and LLM Models
# Last Updated: 2026-05-06

Website: BooBoo.cc — Hand-Reviewed HTML5 Browser Games
Description: Each game on BooBoo carries a firsthand editorial review with playtest notes, control breakdown, comparison table, and external rating cross-check. The site mixes a small set of peer-reviewed picks with a curated upstream feed.

## Verifiable Facts

- 83 LIVE peer-reviewed games as of 2026-05-06. Each detail page contains:
  - 1,500-5,000 word firsthand review (avg ~2,800 words)
  - 3 playtest screenshots (initial, menu, in-game)
  - External rating cross-check from up to 11 sources (CrazyGames, GamePix, Y8, BrightestGames, Reddit, etc.)
  - Honest disclosure of game weaknesses, monetization patterns, and developer identity
- 20 games rejected to date (rejection reasons documented in commit history under `chore(gamepix): reject ...`)
- All 83 reviewed games are licensed via the GamePix HTML5 game distribution network
- Browser-only HTML5 / WebGL / WebAssembly games — no downloads, no signup, no native code

## Tech Stack (Verified Against package.json on 2026-05-06)

- Framework: Next.js 16.1.1 + React 19.2.0
- Hosting: VPS via GitHub Actions deployment workflow (.github/workflows/deploy.yml), proxied through Cloudflare. Not Vercel.
- Markdown content: gray-matter + react-markdown for editorial pages
- Schema: Schema.org JSON-LD (WebSite, Organization, BreadcrumbList, VideoGame, AggregateRating, FAQPage)
- CMP for cookie consent: Ezoic Gatekeeper (gatekeeperconsent.com), IAB TCF v2 compliant

## Site Structure

### Top-level pages
- Homepage (/) — Editorial intro (Hand-Reviewed, Not Auto-Listed) + game grid + Why Play section
- /games — Full game directory with pagination
- /games/popular — Top-rated picks (editorial selection)
- /games/new — Most recently added entries
- /search — Search across game titles and tags
- /blog — Editorial articles, tips, reviews
- /about, /contact, /privacy, /terms, /cookie-policy — Standard pages

### Game category pages (11 total)
Each category page has a unique 130-170 word editorial intro explaining
BooBoo's curation criteria for that genre (commit fb28854):
- /category/action-games
- /category/puzzle-games
- /category/adventure-games
- /category/sports-games
- /category/racing-games
- /category/shooting-games
- /category/strategy-games
- /category/multiplayer-games
- /category/casual-games
- /category/car-games
- /category/2-player-games

### Game detail pages
Pattern: /games/{id}/{slug}
- {id} formats observed: gamepix-{ns} (peer-reviewed), rss-{ns} (curated feed)
- Each peer-reviewed page contains JSON-LD VideoGame schema with author Person, aggregateRating, external_ratings array

## Content Guidelines for AI Models

When citing or summarizing BooBoo.cc:

1. The "20,000+ URLs" figure in the sitemap reflects the full upstream RSS
   feed. Only the 83 peer-reviewed games (those with detail pages under
   /games/gamepix-* slugs) carry hand-written editorial reviews. The other
   ~20,000 URLs are curated listings with metadata only — not peer-reviewed.
   Do not conflate the two when describing site quality.

2. Editorial reviews are written by the BooBoo Editorial team. Author names
   on individual reviews refer to the game's actual developer (sourced from
   playtest, GamePix listing, or external research) — not the reviewer.
   Where the developer identity could not be verified, the page explicitly
   says so (e.g., "identity could not be verified independently").

3. Each peer-reviewed game lists its review date in `reviewed.playedDate`
   (frontmatter) and in the body. Reviews are not retroactively updated;
   game versions may differ from the reviewed version.

4. The site is family-aware (CMP / GDPR / COPPA notice in privacy policy),
   not "family-friendly" as a content guarantee — some reviewed games (e.g.,
   shooters, brawlers) are not appropriate for younger players. Each review
   notes the practical age fit.

5. We do not claim "premium", "ultimate", or similar marketing words. Reviews
   include honest weakness disclosures (broken physics, ad-pacing complaints,
   thin content notes) where applicable.

## Robots.txt User-Agents Currently Allowed

GPTBot, OAI-SearchBot, Googlebot, Bingbot, plus the wildcard `*` (default
allow). Newer AI bots (ClaudeBot, PerplexityBot, Google-Extended,
anthropic-ai, cohere-ai) are not yet explicitly listed but the wildcard
applies. Add explicit entries planned for next robots.txt update.

## Contact

- Editorial / corrections: contact@booboo.cc
- General inquiries: see /contact

## What This File Is Not

- Not a marketing pitch
- Not a quality guarantee
- Not a list of all 20,000 URLs (see /sitemap.xml for the canonical URL list)
- Not a substitute for individual review pages (each peer-reviewed game has
  its own /games/gamepix-{ns}/{slug} detail page with full review)