⚡ Translify

Intelligent i18n CLI — extract, sync, detect, translate.

Automate your entire internationalization workflow from a single terminal command.

---

What is Translify?

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

• Extract all translation keys used in your source code
• Sync translation files across languages — add missing keys, remove stale ones
• Detect unused, missing, and duplicate translation entries
• Translate automatically via AI providers (OpenAI GPT-4)
• Audit your entire i18n health in one command
• Optimize translation files (sort, deduplicate, format)

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 with full TypeScript autocompletion.

Extract translation keys

translify extract

Scans your source files for all t(), i18n.t(), translate() calls and reports which keys are in use.

Sync translation files

translify sync

Adds missing keys to all language files, keeping them in sync with your base language.

Find unused keys

translify unused

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

Run a full audit

translify audit

Runs all checks (missing, unused, duplicates) in one pass — great for CI.

---

Configuration

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

import { defineConfig } from '@ndnci/translify/config';

export default defineConfig({
  source: {
    include: ['src/**/*.{ts,tsx,js,jsx}'],
    exclude: ['**/*.test.*', '**/node_modules/**'],
  },

  translations: {
    default_language: 'en',
    files: ['messages/*.json'],
  },

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

  ai_translation: {
    enabled: false,
    provider: 'openai',
    openai_api_key: process.env.OPENAI_API_KEY,
    model: 'gpt-4.1-mini',
    temperature: 0,
  },
});

---

Commands

Command	Description
translify init	Initialize a config file
translify extract	Extract all translation keys from source code
translify sync	Sync translation files across languages
translify translate	Auto-translate missing keys via AI
translify unused	Detect unused translation keys
translify missing	Detect missing translation keys
translify duplicate	Detect duplicate translation values
translify optimize	Optimize and format translation files
translify audit	Full i18n audit (all checks combined)
translify doctor	Check your Translify setup and environment

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 to auto-translate your keys:

translify translate --locale fr

Requires ai_translation.enabled = true in your config and a valid OPENAI_API_KEY.

---

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

• Key extraction from TS/JS/TSX/JSX
• Translation file sync
• Unused / missing / duplicate detection
• AI translation via OpenAI
• 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.