jedarden/ai-code-battle
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ai-code-battle/docs/notes/canonical-public-domain.md
jedarden 90f4ed7507 docs(bf-5kk): standardize on ai-code-battle.pages.dev as canonical public domain 
- Update replay-schema-v1.json  to pages.dev
- Update robots.txt sitemap URL to pages.dev
- Update test-match-list.html thumbnail URLs to pages.dev/r2/
- Add decision note documenting standardization

All user-facing absolute URLs now use the working pages.dev origin.
The aicodebattle.com domain is NXDOMAIN and was never registered.
R2 data is served through Pages Functions (/r2/*) eliminating the
need for a separate b2.aicodebattle.com CDN host.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-07-02 14:13:44 -04:00

2.7 KiB
Raw Blame History

name description metadata
canonical-public-domain Standardized on ai-code-battle.pages.dev as canonical public domain
type
project

Canonical Public Domain Decision

Decision

Standardized on ai-code-battle.pages.dev as the canonical public domain.

Background

The domain aicodebattle.com is NXDOMAIN (not registered). The site is deployed and functional at ai-code-battle.pages.dev. References to aicodebattle.com and b2.aicodebattle.com existed in documentation and test files.

Rationale

  • Registering aicodebattle.com requires human action and payment
  • Cloudflare Pages provides a production-ready public URL at ai-code-battle.pages.dev
  • R2 storage is now served through Pages Functions (/r2/* path), eliminating the need for a separate b2.aicodebattle.com CDN host
  • Standardizing on pages.dev ensures all user-facing URLs work immediately

Changes Made

Updated Files

  1. web/public/replay-schema-v1.json

    • Updated $id field from https://aicodebattle.com/replay-schema-v1.json to https://ai-code-battle.pages.dev/replay-schema-v1.json

  2. web/public/robots.txt

    • Updated sitemap URL from https://aicodebattle.com/sitemap.xml to https://ai-code-battle.pages.dev/sitemap.xml

  3. web/public/test-match-list.html

    • Updated thumbnail URL from https://b2.aicodebattle.com/thumbnails/... to https://ai-code-battle.pages.dev/r2/thumbnails/...

Files Already Correct

  • web/src/og-tags.ts - Already uses https://ai-code-battle.pages.dev
  • web/src/pages/playlists.ts - Uses dynamic window.location.origin for embed URLs
  • web/src/pages/clip-maker.ts - Twitter share uses external domain (correct)
  • web/index.html - OG tags already use pages.dev
  • web/embed.html - OG tags already use pages.dev

URL Pattern

All user-facing absolute URLs now follow the pattern:

https://ai-code-battle.pages.dev/<path>

Dynamic URLs use window.location.origin which resolves to pages.dev in production.

Replay and Data URLs

Replays and match data are served through Cloudflare Pages Functions:

  • Replays: https://ai-code-battle.pages.dev/r2/replays/{match_id}.json.gz
  • Match metadata: https://ai-code-battle.pages.dev/r2/matches/{match_id}.json
  • Thumbnails: https://ai-code-battle.pages.dev/r2/thumbnails/{match_id}.png
  • Bot cards: https://ai-code-battle.pages.dev/r2/cards/{bot_id}.png
  • Evolution status: https://ai-code-battle.pages.dev/r2/evolution/live.json

Future Consideration

If aicodebattle.com is registered later, it can be added as a custom domain in Cloudflare Pages. The internal URLs will remain valid as pages.dev will continue to work as the origin.

Verified

All user-facing absolute URLs emitted by the web application resolve correctly in a browser.