Skip to main content

​
Internationalization

The Zopio CLI provides robust tools for managing translations and locales in your zopio application. This page covers how to use the CLI to add, update, and manage translations.

​
Directory Structure

The Zopio framework uses both next-international and next-intl for internationalization, which requires translations to be stored in two locations: 
├─ locales/
│  ├─ en/
│  │  └─ common.json
│  └─ tr/
│     └─ common.json
├─ dictionaries/
│  ├─ en/
│  │  └─ common.json
│  └─ tr/
│     └─ common.json
├─ i18nConfig.ts
└─ languine.json

​
i18n Command

The i18n command helps you manage translations and locales in your zopio application. 
zopio i18n [options]

​
Options

  • --add <locale> - Add a new locale
  • --remove <locale> - Remove a locale
  • --extract - Extract translation keys from source files
  • --sync - Synchronize translation files across locales
  • --check - Check for missing translations
  • --default <locale> - Set the default locale

​
Examples

zopio i18n --add tr

​
Supported Locales

The Zopio CLI supports the following locales out of the box:
  • en - English (default)
  • tr - Turkish
  • es - Spanish
  • de - German
You can add support for additional locales using the i18n --add command.

​
Configuration

The internationalization system is configured through two files:

​
i18nConfig.ts

// i18nConfig.ts
export const i18nConfig = {
  defaultLocale: 'en',
  locales: ['en', 'tr', 'es', 'de'],
  localeDetection: true,
  localePrefix: 'always'
};

​
languine.json

// languine.json
{
  "defaultLocale": "en",
  "supportedLocales": ["en", "tr", "es", "de"],
  "fallbackLocale": "en",
  "namespaces": ["common", "auth", "dashboard"],
  "translationDirs": [
    "dictionaries",
    "locales"
  ]
}

​
Using Translations in Components

The Zopio CLI generates components with internationalization support built-in:

    ​
    Translation Management

    The Zopio CLI provides several commands to help you manage translations:

    ​
    Extract Translation Keys

    zopio i18n --extract
    This command scans your source files for translation keys and adds them to your translation files.

    ​
    Synchronize Translations

    zopio i18n --sync
    This command ensures that all translation files have the same keys across all locales.

    ​
    Check for Missing Translations

    zopio i18n --check
    This command identifies missing translations in your locale files.