---
url: /docs/en/agentbuff-stack/new-site.md
---
# 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

```sh
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

```sh
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.