Languages and translation
The template ships English and Simplified Chinese. Optional Spanish support is retained. The official site always has English/Chinese pages independently of product language configuration. Core documentation is bilingual; historical acceptance and iteration records stay in Chinese.
Configure a product
Keep English first in websiteConfig.i18n.locales, and keep metadata.language set to en. Supply complete translated tagline, two hero lines, description and Free/Starter/Pro descriptions in translations.zh before enabling Chinese. Optional disabled translations may be null.
English routes stay unchanged. Chinese uses /zh/: public pages, tools, articles, authentication, dashboard, tasks, files, history, purchases, members, invitations, settings and administration. API endpoints, signed auth endpoints, private download endpoints and application assets keep root paths.
No automatic browser-language redirect or language cookie is introduced. URL selection is explicit. Rebuild every application after changing enabled languages; disabling Chinese removes its public pages and edge entry rather than presenting a fake translation.
Add or edit copy
| Content | Location |
|---|---|
| Product metadata/plan descriptions | packages/core/website.ts |
| Language registry and paths | packages/core/locales.ts, routing.ts |
| Public UI and tools | apps/web/lib/locales/, packages/core/tool-locales.ts |
| Workspace and stable error codes | apps/app/lib/locales/, locale-errors.ts |
| Email subjects, preview and bodies | apps/email/locales.ts |
| Actual product articles | apps/web/content/blog/zh/ |
| Independent official site copy | apps/website/lib/i18n.ts, modules.ts |
| English core guides | docs/en/agentbuff-stack/ |
Chinese dictionaries match English dictionary types. Do not translate identifiers, amounts, brand names, secrets, user inputs, raw error evidence or original audit notes. Dates and money use the selected locale while authoritative values remain unchanged.
Switching and authentication
Public language menus link only to existing versions of the current page. Public switching does not copy arbitrary query/token values. Tools reload on a language change; copy unsaved inputs first. The anonymous save flow preserves tab-local input through its safe sign-in return, then restores preview without automatically saving it.
Workspace switching retains supported task/purchase IDs, query and fragment, and updates safe returnTo destinations. Password/OTP, registration, provider callbacks and reset links preserve the supported selected route. Unknown origins and unsafe destinations are rejected by the existing redirect guard.
Immediate emails use the enabled request language, falling back to English for unknown/disabled values. Marketing requests and task preferences persist their chosen language; later page changes do not rewrite queued retries. Checkout language is retained with its original request. This is presentation, never permission or tenant selection.
Documentation
Chinese guides retain their original routes; English core guides use /en/. Each paired guide has a direct counterpart link. The global language menu returns to a language home, avoiding nonexistent English versions of Chinese-only history. English search indexes English guides; history links clearly say “Chinese.”
Translations were written from the repository's shipped English content and should be reviewed when adapting business descriptions. Local behavior checks do not prove real inbox delivery, provider checkout localization or published search indexing.