What is Translify?

Translify is a professional, framework-agnostic CLI that automates the hardest parts of i18n:

• Add missing keys to translation files across languages, preserving existing formatting
• Split large translation files into context files while still treating each language as one catalogue
• Detect unused, missing, duplicate, and cross-locale inconsistent translation entries, plus hardcoded user-facing text
• Translate automatically via AI providers (OpenAI or OpenRouter)
• Audit your entire i18n health in one command
• Fix deterministic audit issues with --dry-run previews

Built for teams that care about DX and translation quality.

Quick Start

# Install globally
npm install -g @ndnci/translify

# Or run directly without installing
npx translify@latest init

Initialize a config

translify init

Creates a translify.config.ts in your project root.

Run a full audit

translify audit

Runs every check (missing, unused, duplicate values, duplicate keys, cross-locale inconsistencies, hardcoded text) in one pass — great for CI.

Add missing keys

translify add-missing --dry-run
translify add-missing

Adds missing keys to all language files, keeping them in sync with your base language, without touching the existing formatting of each file.

Find unused keys

translify check-unused

Finds translation keys defined in your JSON files but never referenced in code.

Split large files

translify split-translations --dry-run
translify split-translations --groups "tools=tool|foo,auth=auth"

Splits files such as messages/en.json into context files such as messages/en/tools.json, while audits and fixes continue to treat all files for one language as a single catalogue.

Configuration

Create a translify.config.ts at your project root:

// Optional editor autocomplete:
// /** @type {import('@ndnci/translify/config').TranslifyConfig} */
export default {
  source: {
    include: ['src/**/*.{ts,tsx,js,jsx}', 'app/**/*.{ts,tsx,js,jsx}'],
    exclude: ['**/*.test.*', '**/node_modules/**'],
  },

  translations: {
    default_language: 'en',
    files: ['messages/**/*.json'],
    split: {
      depth: 1,
      groups: [{ name: 'tools', match: ['tool'] }, 'auth'],
      group_match: 'keys',
      output_pattern: 'messages/{language}/{group}.json',
    },
  },

  extraction: {
    translation_functions: ['t', 'i18n.t', 'translate'],
    namespace_functions: ['useTranslations', 'getTranslations'],
    ignored_words: ['OK', 'API'],
    ignored_patterns: ['^v[0-9]+$'],
  },

  ai_translation: {
    enabled: false,
    provider: 'openai',
    openai_api_key: process.env.OPENAI_API_KEY,
    openrouter_api_key: process.env.OPENROUTER_API_KEY,
    model: 'gpt-4.1-mini',
    temperature: 0,
    batch_size: 50,
    verify: false,
    verify_model: undefined,
    values_only: false,
  },
};

Commands

| Command | Description | | ------------------------------ | --------------------------------------------------------- | | translify init | Initialize a config file | | translify config-upgrade | Add new config keys without overwriting existing values | | translify audit | Full i18n audit (all checks combined) | | translify check-config | Validate config values and unknown keys | | translify add-missing | Add missing keys to translation files across languages | | translify add-languages | Create files for one or more new languages | | translify split-translations | Split large translation files by context | | translify audit-fix | Fix deterministic audit issues | | translify hardcoded-fix | Replace hardcoded text with i18n calls | | translify translate | Auto-translate missing keys via AI | | translify check-missing | Detect missing translation keys | | translify check-unused | Detect unused translation keys | | translify check-duplicates | Detect duplicate translation values and duplicate keys | | translify check-consistency | Detect keys missing in some locales but present in others | | translify check-hardcoded | Detect hardcoded user-facing text | | translify optimize | Optimize and format translation files | | translify version | Print the installed version and check for updates | | translify upgrade | Update the globally installed CLI to the latest version |

Global options

-c, --config <path>   Path to config file
    --cwd <path>      Working directory (default: process.cwd())
    --dry-run         Preview changes without writing files
    --verbose         Enable verbose output
-V, --version         Print version
-h, --help            Show help

Framework Support

| Framework / Library | Status | | ------------------- | ------------ | | React | ✅ Supported | | Next.js | ✅ Supported | | TypeScript | ✅ Supported | | JavaScript | ✅ Supported | | i18next | ✅ Supported | | next-intl | ✅ Supported | | Vue | 🔜 Planned | | Angular | 🔜 Planned | | Svelte | 🔜 Planned | | Laravel / PHP | 🔜 Planned |

AI Translation

Translify integrates with OpenAI and OpenRouter to auto-translate your keys:

translify translate --locale fr

Requires ai_translation.enabled = true in your config and the provider API key (OPENAI_API_KEY or OPENROUTER_API_KEY). OpenRouter can use any model slug from its catalogue, for example anthropic/claude-sonnet-4 or openai/gpt-4.1-mini.

Packages

This repository is a monorepo. The following packages are published:

| Package | Description | | ------------------------- | ---------------------------------- | | @ndnci/translify | CLI — the main tool | | @ndnci/translify-core | Core logic (scanner, parser, etc.) | | @ndnci/translify-config | Config loading and validation | | @ndnci/translify-ai | AI translation providers | | @ndnci/translify-shared | Shared types and utilities |

Roadmap

• [x] Key extraction from TS/JS/TSX/JSX
• [x] Translation file sync
• [x] Unused / missing / duplicate detection
• [x] AI translation via OpenAI and OpenRouter
• [x] Full audit command
• [ ] Vue SFC parser
• [ ] Angular template parser
• [ ] PHP/Laravel support
• [ ] Translation memory / TM integration
• [ ] Web dashboard
• [ ] VS Code extension

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

MIT License with Trademark Policy — see LICENSE and TRADEMARK_POLICY.md.

The name Translify and the @ndnci/translify npm scope are trademarks of their respective owners and may not be used for redistributed or renamed versions.