Skip to content

docs(kb): fix the <T> example that the CLI rejects #608

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Kevin-Liu-01 wants to merge 2 commits into from
Closed

docs(kb): fix the <T> example that the CLI rejects #608

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
755ad83
docs(kb): fix the <T> example that the CLI rejects
Kevin-Liu-01 Oct 10, 2026
bd26d9f
Merge main into k/docs-kb-t-example
Kevin-Liu-01 Oct 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 8 additions & 3 deletions kb/en-US/i18n-without-translation-files.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,15 +50,18 @@ ICU message syntax makes this worse. The format libraries like `i18next`, `react
What if you didn't extract strings at all?

```tsx
import { T } from 'gt-react';
import { T, Num, Branch } from 'gt-react';

function CheckoutSummary({ itemCount, discount }) {
return (
<T>
<div>
<h2>Order Summary</h2>
<p>You have {itemCount} items in your cart.</p>
{discount && <p>{discount}% discount applied!</p>}
<p>You have <Num>{itemCount}</Num> items in your cart.</p>
<Branch
branch={discount > 0}
true={<p><Num>{discount}</Num>% discount applied!</p>}
/>
<p>Total (before tax):</p>
<small>Tax calculated at checkout.</small>
</div>
Expand All @@ -69,6 +72,8 @@ function CheckoutSummary({ itemCount, discount }) {

The [`<T>`](/docs/react/reference/components/t) component in [`gt-react`](/docs/react/react-quickstart) marks a block of JSX for translation. The English stays in your component. When a user visits in Spanish, the content inside [`<T>`](/docs/react/reference/components/t) is replaced with its Spanish equivalent. Structure and formatting carry over.

Values that change at runtime go inside variable components such as [`<Num>`](/docs/react/reference/components/num), and conditional content goes inside [`<Branch>`](/docs/react/reference/components/branch). The CLI stops with an error when a [`<T>`](/docs/react/reference/components/t) has children that can change at runtime.

There's no `t('checkout.summary.title')`, no `en.json`, no per-locale JSON files to keep in sync.

## Translations as build output
Expand Down
Loading