Validate, sync, prune, and generate translations with a CI-friendly CLI and a stable SDK — schema-first, preserve-aware, and readable in human or JSON mode.
CLI (terminal):
npm install -g i18nprune
# or: pnpm add -g i18npruneOn demand (no global install):
npx i18nprune --help
pnpm dlx i18nprune --helpSDK (embed in your app):
npm install @i18nprune/core
# or: pnpm add @i18nprune/coreThe i18nprune npm package ships the CLI. Prefer @i18nprune/core when you import APIs from Node or workers.
i18nprune init
i18nprune validate
i18nprune sync --dry-run
i18nprune missing --target all
i18nprune generate --resume --allStart with Onboarding for the shortest path, then Commands for day-to-day ops.
| Topic | What you will learn |
|---|---|
| Onboarding | CLI / SDK / CI / hosted paths to first value |
| Commands | Per-command reference |
| Examples | CI gates, jq recipes, generate --resume |
| Config | defineConfig, locales layout, policies |
| Policies | copyPrefixes, uncertainPrefixes, parity |
| CLI overview | Global flags and argument preprocessing |
JSON (--json) | Machine-readable envelope for scripts and CI |
| Issues | Stable issue codes and remediation |
| Architecture | System layers and data flow |
| SDK operations | Programmatic runXxx surfaces |
| Release notes | CLI and Core version history |
Schema-first, host-thin. Core owns detection, cache policy, and locale IO contracts. The CLI is a thin host for prompts, progress, and --json. Preserve and uncertain-prefix rules are one config contract across sync, cleanup, and generate — not per-command workarounds.