i18nexus CLI

4.1.0 verified Sat Apr 25 auth: no javascript

Command line tool for managing translations via the i18nexus API. Version 4.1.0. Provides commands to download translation files (pull) and view project metadata. Supports i18next, next-intl, and react-intl file structures. Loads .env for API key. Active development with monthly releases.

Common errors

error Error: Failed to fetch translations. Check API key and network. ↓

cause Invalid project API key or network issue.

fix

Verify I18NEXUS_API_KEY or --api-key, ensure internet connectivity.

error Error: API key not provided. Use --api-key or I18NEXUS_API_KEY environment variable. ↓

cause No API key supplied.

fix

Provide --api-key flag or set I18NEXUS_API_KEY in environment.

Warnings

gotcha Environment variables are loaded from .env file in current directory unless I18NEXUS_NO_DOT_ENV is set. ↓

fix Set I18NEXUS_NO_DOT_ENV=true or ensure .env contains correct keys.

gotcha The --clean flag only deletes folders matching simple language code regex; files may remain if not in such folders. ↓

fix Manually verify destination folder before using --clean.

gotcha Default download path depends on i18nexus project library setting (i18next, next-intl, react-intl). ↓

fix Use --path to override destination.

Install

npm install i18nexus-cli

yarn add i18nexus-cli

pnpm add i18nexus-cli

Quickstart

Install globally and pull translations using an API key from environment or flag.

npm install -g i18nexus-cli
i18nexus pull -k $I18NEXUS_API_KEY || echo 'Set I18NEXUS_API_KEY or use --api-key'
i18nexus project -k $I18NEXUS_API_KEY