i18next Localization Setup
Takes an app from hardcoded strings to a fully localized, continuously translated one using i18next-cli and Locize.
Dev & CodingIntermediate★ 234⑂ 36AI score 9/10Last updated: Sep 2, 2026
What it does
- Runs
npx i18next-cli localize --print-agent-promptso the agent always follows the version-matched workflow instead of a stale copy. - Walks the full pipeline: stack detection →
init(writesi18next.config.ts) →instrument(AST-wraps hardcoded strings int()) →extract(generates locale JSON) →locize-sync/locize-download(push keys, AI-translate, pull back). - Insists on
instrument --dry-runfirst and a git diff review afterwards (e.g. Next.js server components may need'use client'). - Handles stack specifics: Vue via
i18next-cli-vue, Svelte viai18next-cli-plugin-svelte, added to thepluginsarray. - Defines hard stops: competing i18n libraries (next-intl, react-intl, vue-i18n, Paraglide, Lingui, Tolgee) or a dirty working tree pause the run and ask the user.
Who it's for
- Frontend developers internationalizing a React/Next.js/Vue/Svelte app for the first time.
- Teams whose project already uses i18next but still has hardcoded strings.
- Teams that want locale files managed in a hosted backend with AI translation.
Examples
- "Add i18n to my React app" → verifies
i18next+react-i18nextare installed, writes config, prints the dry-run plan. - "I want German and French support" → extracts keys, syncs to Locize, AI-translates, downloads translations back into the repo.
- "Find hardcoded strings and wrap them" → runs
instrumentinstead of hand-editing, then reviews the diff before extraction.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/i18next/i18next-cli/HEAD/skills/i18next-localization/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/i18next-localization folder from the GitHub repo i18next/i18next-cli into my ~/.claude/skills/i18next-localization/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/i18next/i18next-cli.git /tmp/i18next-cli && mkdir -p ~/.claude/skills && cp -r /tmp/i18next-cli/skills/i18next-localization ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repo:
git clone https://github.com/i18next/i18next-cli.git /tmp/i18next-cli - Create the skills directory if needed:
mkdir -p ~/.claude/skills - Copy the skill in:
cp -r /tmp/i18next-cli/skills/i18next-localization ~/.claude/skills/ - Confirm bundled reference files (such as
references/stacks.md) came along. - Make sure Node.js is available — test with
npx i18next-cli --help. - For the Locize part, create a project at https://www.locize.app and export
LOCIZE_PROJECTIDandLOCIZE_API_KEYas environment variables. Never embed the API key in client-side code. - Restart Claude Code and ask something like "internationalize my app". Commit your work first so the instrumentation diff is reviewable.
View source on GitHub ↗License: MIT