Hosting

Burrow™’s public site is a Next.js app on Vercel. It hosts documentation and marketing only. Inventory runs in the Burrow™ Mac app. The Swift engine stays on the local Mac. Retired console routes redirect to /.

The Vercel project name is vault, rooted at apps/web, linked to GitHub PlatypusDBA/Burrow. Pull requests get preview URLs automatically.

Generated canonical links come from apps/web/lib/site.ts and apps/web/lib/site-environments.json. CI builds each environment and fails if data-site-url / public/site-env.json do not match.

GitHub Actions

The quality job in .github/workflows/ci.yml runs on ubuntu-latest (VLT-145). It gates PRs with lint, typecheck, test, and build. Swift is skipped on Linux because BurrowEngine targets macOS 14 and uses Darwin, Network, and os.

The Engine workflow (.github/workflows/engine.yml) is the documented macOS-only check. It runs on macos-latest when engine/ changes so site-only PRs do not pay 10× macOS minutes.

What is hosted

The Next.js site serves:

• the product landing page at /;
• the documentation portal at /docs, rendered from repository markdown.

It does not:

• talk to the local Swift engine from the public internet;
• scan, inventory, or mutate files on any Mac;
• receive arbitrary filesystem access;
• upload inventory to a SaaS backend.

A browser on HTTPS cannot call http://127.0.0.1:8741 because mixed content is blocked. The hosted site does not offer a console. Local http://localhost:3000 is the same documentation site. Run the Burrow™ Mac app on this computer for inventory.

Build

Vercel installs apps/web and runs next build. The build copies /docs into the web app and writes public/site-env.json for the current environment.

Local app:

cd apps/web && npm install && npm run dev

MkDocs remains the strict documentation source for agents and make docs. It is not what Vercel publishes.

make docs
make docs-serve

Environment variables

If those are unset, VERCEL_ENV selects preview vs production, and everything else is local.

Domains

jasonkoch.io is already on Vercel. Burrow™ uses:

• burrow.jasonkoch.io — production
• burrow-dev.jasonkoch.io — development / preview (preview branch)

The Vercel project slug stays vault. Retired hostnames vault.jasonkoch.io and vault-dev.jasonkoch.io are no longer assigned to this project. Site chrome links back to the apex jasonkoch.io.

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

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

GitHub Pages

GitHub Pages is not used. Do not enable it for this repository unless Vercel is unavailable.

Jira

Hosting work is tracked as VLT-127 / VLT-128. Hostname cutover to Burrow™ is VLT-133.