Skip to content

Domains & routing

The platform lives entirely under patternyard.dev, a Vercel-registered domain on Vercel Edge (DNS is auto-managed — there is no external nameserver step). Each surface gets its own subdomain, mapped to a Vercel project.

SubdomainProjectServes
patternyard.dev + www.patternyard-homeThe home / community site
studio.patternyard-studioThe editor
api.patternyard-backendThe backend API (projects, accounts, assets)
packager.patternyard-packagerProject → HTML/exe packager
extensions.patternyard-extensionsExtension gallery + manifests
docs.patternyard-docsProduct documentation
library.patternyard-libraryCostumes, sounds, backpack, project assets
Diagram

Each subdomain was added to its project with:

Terminal window
vercel domains add <subdomain>.patternyard.dev <project> \
--scope team_1A5hxCsAnX5KFLm69oklRZWB

Because the domain is Vercel-registered and on Vercel Edge, DNS records are created automatically — there is no separate registrar step.

The editor (studio.) and home (apex) being different origins is the single most consequential routing fact. It means:

  • Credentialed editor → backend calls must be on the backend’s CORS allowlist (the allowlist includes both studio. and the www/apex home origin).
  • The editor cannot read the home session directly; it uses the cross-origin /embed/editor login bridge.
  • Auth callback URLs and email links must point at the right origin — the backend builds these from its ApiURL / HomeURL / StudioURL env vars, not hardcoded hosts.

See the environment reference for exactly which variable points where.