Create an independent site

Start with a clearly deliverable task: input → processing → checkable preview → download/export. Validate actual market evidence separately. The template's sample tools are engineering examples.

Generate the project

bun run site:create /absolute/path/my-tool \
  --name "My Tool" --domain https://my-tool.com --port 4700

The factory creates independent source and configuration. It excludes secrets, Git history, databases, local state, dependencies, builds and the template official website. template.json records provenance for later upgrades. Install dependencies and prepare a separate database and authentication secret in the new directory.

Bindings, storage/queue names, dead-letter configuration and routes are rewritten by environment. Cloud account/Hyperdrive IDs become placeholders; remote local-resource flags are disabled. Unsupported resource bindings cause a deliberate failure rather than an unsafe copy.

Replace product content

Edit packages/core/website.ts: brand, English and enabled-language descriptions, contact, limits, plans and actual tool behavior. The factory resets brand assets/social/contact and clears credit-pack sales; never reuse the source site's provider products.

Add real processor/input/output handling in the existing tool/task boundaries. The shipped workbench handles text input/output. Images, PDF, video and external models require their own validation, preview, delivery, costs and recovery; changing labels is insufficient.

Put English articles in the root blog folder and complete Chinese versions in zh/ with matching filenames. Preserve IDs and source data. Replace sample author/date/facts and policy drafts before publishing. Missing Chinese articles do not generate fake translations.

Run locally

bun install --frozen-lockfile
cp .env.example .env.local
# Configure a fresh secret and isolated loopback database first.
bun run config:check
bun db:migrate
bun preview:build
bun preview:start

Use the generated preview URL and its /zh/ counterpart. Test the full task, sign-in return, private history, another account's access and refresh behavior. Resource/credential preparation for production is a later deliberate step; generation does not deploy or create cloud resources.

English/Chinese are enabled by the template. If your product only supplies English, use locales: ["en"], check and rebuild. Never publish untranslated business claims under a Chinese language label.