Internationalization taste — ChatGPT prompt for product localization
The Internationalization taste ChatGPT prompt sets out product internationalization practices. It covers localized UI text, data formats, and public pages.
CC0-1.0 ★ 178,201 updated 2026-10-24
Open on GitHubWhat Internationalization taste does
The prompt recommends moving user-facing copy into messages with semantic keys, using ICU MessageFormat for plural and selection rules, and giving translators context. For dates, numbers, currencies, and sorting, it points to Intl APIs configured for the user's locale.
Other guidance covers storing timestamps in UTC, representing money in minor units, and supporting right-to-left languages. For public pages, it suggests locale-specific URL paths and hreflang alternates. It also describes pseudo-localization in CI and failing builds when the default locale has missing keys. Emails, notifications, and PDFs are included too.
For Claude Code, the listed file path is .claude/commands/prompts.csv.md.
What it helps with
- move user-facing copy out of application code
- handle plural forms and selections with ICU rules
- format dates and currencies for each locale
- test layouts with longer translations and RTL text
- set up localized public URLs and
hreflangalternates
Example prompts for the agent
- Review my app's internationalization plan using these recommendations.
- Find localization issues in this interface and suggest changes.
- Explain how to handle dates, currencies, and plural forms across locales.
How to install Internationalization taste
How to use
Paste the text at the start of a chat or into project instructions
Manually: put the files in place
.claude/commands/prompts.csv.mdQuestions about Internationalization taste
How do I install Internationalization taste in Claude Code?
Use the file path .claude/commands/prompts.csv.md.
What does Internationalization taste do?
It offers product internationalization guidance for messages, formatting, UI layouts, and public pages. It also covers RTL languages, translated communications, and CI checks.
How does the prompt recommend testing translations?
It suggests running pseudo-localization in CI, failing builds for missing default-locale keys, and falling back gracefully when other locales lack translations.
Source text
prompts.csv · CC0-1.0
# Internationalization taste of a product engineer shipping to many locales - Externalize every user-facing string from the first commit; retrofitting i18n later costs far more than starting with it. Confidence: 0.90 - Use ICU MessageFormat (via `formatjs`, `i18next` with ICU, or similar) so plurals, gender and select rules live in the message, not in code. Confidence: 0.90 - Never build sentences by concatenating fragments; translators need the whole sentence with named placeholders. Confidence: 0.95 - Use semantic message keys like `checkout.payButton` instead of using the English text as the key. Confidence: 0.75 - Give translators context: a description for every message and screenshots for ambiguous ones. Confidence: 0.85 - Format dates, numbers, currencies and lists with `Intl` APIs and the user's locale, never with hand-written format strings. Confidence: 0.95 - Store timestamps in UTC and convert to the user's time zone only at display time. Confidence: 0.95 - Store money as integer minor units plus an ISO 4217 currency code, and let the locale decide symbol placement. Confidence: 0.90 - Use BCP 47 locale tags (`pt-BR`, `zh-Hant`) everywhere and define an explicit fallback chain down to the default language. Confidence: 0.85 - Support right-to-left languages with CSS logical properties (`margin-inline-start`) and `dir="auto"` instead of left and right. Confidence: 0.85 - Design layouts to absorb text that runs 30 to 40 percent longer than English, and test with pseudo-localization in CI. Confidence: 0.85 - Fail the build on missing keys in the default locale, but fall back gracefully for missing translations in other locales. Confidence: 0.80 - Keep translation files in the repo and sync them with a translation platform through automation, not manual copy and paste. Confidence: 0.80 - Put the locale in the URL path (`/de/pricing`) for public pages and emit `hreflang` alternates for SEO. Confidence: 0.80 - Detect the initial locale from `Accept-Language`, then let the user override it and remember the choice. Confidence: 0.85 - Sort and compare user-visible strings with `Intl.Collator`, and lowercase or uppercase with locale-aware methods (think Turkish dotted i). Confidence: 0.80 - Lazy-load translation bundles per locale and per route so users do not download every language. Confidence: 0.75 - Translate emails, push notifications, PDFs and error messages too, not only the web UI. Confidence: 0.85 - Avoid text inside images and icons; when unavoidable, provide localized variants. Confidence: 0.75 - Accept names, addresses and phone numbers in flexible formats instead of forcing a US-centric form layout. Confidence: 0.80
© f · CC0-1.0 · f/prompts.chat