Official website, showcase and demo
The template official website, generated products and complete product demo are different surfaces. stack.agentbuff.dev is the intended official template website domain. It is not a real product staging domain. The authorized release contains the static official website and bilingual guides under /docs/. The product demo is hidden until it has a public address; real products remain undeployed.
Independent build
apps/website/ is a static Astro site for the template introduction, features, showcase, blog, pricing availability and docs/demo links. It does not import product runtime configuration or require the product database, authentication, payment credentials or model APIs.
| Public variable | Purpose |
|---|---|
WEBSITE_ORIGIN | Official canonical/feed/sitemap origin |
WEBSITE_DOCS_URL | Public documentation entry |
WEBSITE_DEMO_URL | Separate complete product demo |
Copy .env.website.example to .env.website.local. Set the origin to https://stack.agentbuff.dev, the docs entry to https://stack.agentbuff.dev/docs/agentbuff-stack/, and leave WEBSITE_DEMO_URL empty. Missing destinations hide their links; supplied public destinations must use HTTPS and cannot point to localhost. Local previews retain their ports. Official URLs do not change product APP_ORIGIN.
Run bun website:package to validate the domain and docs entry, then build both sites into a fresh .local/website-release-* directory. The package includes its own Worker configuration and a manifest outside public assets, recording the source revision and whether the source had uncommitted changes. It preserves local preview output. Docs assets, search, paired guide links and canonical addresses use /docs/; the root sitemap index lists both sites.
Check the printed configuration with bunx wrangler deploy --dry-run --config <release-directory>/wrangler.jsonc. Dry-run success does not establish deployment. After Cloudflare login and domain access are ready, upload that reviewed package with bunx wrangler deploy --config <release-directory>/wrangler.jsonc. Alternatively, bun website:deploy builds a fresh combined package and uploads it. Neither website command deploys product Workers or migrates a database. The site factory excludes the official publisher and environment file from generated products.
Bilingual content
English official routes remain unchanged; Chinese uses /zh/. Shared page components use independent website dictionaries. English and Chinese blogs contain full actual articles with localized feeds, schema and canonical links. Only existing content versions appear as language alternates.
Official Markdown uses locale and an optional stable translationKey to pair versions. Drafts do not publish. A translated published entry needs its published source. Missing translations do not produce a false translated detail page.
Showcase cases
A case is an independent site built from the template, with its own origin, screenshots and factual description. The demo's JSON/text tools are not separate showcase cases. Until real cases exist, the site displays an honest empty state. A demo link appears only when its address is configured.
Before adding a case, confirm its independent URL, attribution, source of screenshots and real status. A case page is not proof of traffic, revenue or demand. The site factory excludes official content from generated products.