Build with code

Keep static user-facing text in your components. The build plugin extracts it, and the framework runtime renders translations with the original source as fallback.

Choose the integration task

• Show translated content: provider setup, hosted catalogs, and language switching.
• Dynamic text and links: values, ICU plurals, rich slots, and custom label props.
• Keep product text and code separate: exclusions and the compiler's extraction boundaries.
• Server rendering: resolve the language per request and share hydration state.

These guides use React examples. For Vue, Svelte, or Solid, start with framework setup and the matching runtime reference. TanStack Start uses the request-aware React setup.

Keep the scopes aligned

The build plugin, runtime provider, and published catalog must agree on project, environment, and locale. Build and translation APIs use a secret project token. Browser catalog delivery uses a publishable key.