Website building

The outcome

The company website lives in the company's repository, is hosted by Cargo, and answers on the company's own name. Every change, from a typo to a new page, is a pull request someone reviewed before it deploys. Your coding agent writes those pull requests; nothing is deployed to do it.

Three resources make the site:

1. An app. defineApp uploads the Next.js package in infra/apps/website/, and Cargo runs its build: every page is exported as HTML with its own URL, title and description. The starter has home and about pages, robots.txt, a sitemap, a theme toggle and shadcn/ui on Tailwind, with the copy in site.json.
2. A hostname on the app. domains: ["www.example.com"]. Cargo's own *.app.getcargo.run URL is noindex; the company's www host is what search engines index.
3. A domain, when Cargo holds its DNS. defineDomain publishes the app's records and forwards the apex to www. When the DNS lives at another provider, the file is deleted and the same records are added there.