Hosting

Waypoint™ documentation is a Next.js App Router site hosted on Vercel. Markdown specifications stay in docs/ and are rendered by the app.

EnvironmentHostnameVercel target
Productionwaypoint.jasonkoch.iomain
Developmentwaypoint-dev.jasonkoch.iopreview branch and pull-request deployments

The Vercel project name is waypoint. It is linked to GitHub PlatypusDBA/waypoint. The application root is apps/web. Visual identity lives in brand/; the site copies the official SVG marks into apps/web/public/brand/.

Build

cd apps/web
npm ci
npm run build

Do not add MkDocs, Material, or GitHub Pages as a publisher.

Domains

jasonkoch.io is already on Vercel (jasonkoch-io) and currently uses Cloudflare nameservers. Waypoint™ uses two subdomains on that apex:

  • waypoint.jasonkoch.io — production
  • waypoint-dev.jasonkoch.io — development / preview

If a new subdomain does not resolve, add a Cloudflare CNAME to cname.vercel-dns.com.

SSO deployment protection is disabled so the public docs hostnames are reachable without a Vercel login.

Jira

Hosting and project bootstrap are tracked as WAY-1.