⚡

CLI Tools

Powerful automation tools for text wrapping and translation management

Installation

npm install -D i18nexus-tools

🔧

i18n-wrapper

Auto Text Wrapping

Automatically wrap Korean text with t() and add imports

Basic Usage

# Wrap all Korean text in app directory
npx i18n-wrapper --pattern "app/**/*.tsx"

# Preview changes without modifying
npx i18n-wrapper --dry-run

# Target specific files
npx i18n-wrapper --pattern "app/page.tsx"

📝

Before

export default function Welcome() {
  return (
    <div>
      <h1>환영합니다</h1>
      <p>i18nexus 사용법</p>
    </div>
  );
}

✨

After

import { useTranslation } from "i18nexus";

export default function Welcome() {
  const { t } = useTranslation();
  return (
    <div>
      <h1>{t("환영합니다")}</h1>
      <p>{t("i18nexus 사용법")}</p>
    </div>
  );
}

💡Smart detection

✓Detect Korean text within JSX elements
✓Detect Korean within string literals
✓Detect Korean within template literals
✓Skip already wrapped text
✓Preserve code formatting

🔍

i18n-extractor

Smart key extraction

Extract translation keys and intelligently merge with existing files

Basic Usage

# Extract and merge with existing translations
npx i18n-extractor -p "app/**/*.tsx" -d "./lib/translations"

# Generate specific language files
npx i18n-extractor -l "en,ko,ja"

# Preview without modifying
npx i18n-extractor --dry-run

✨Smart merge feature

✓Preserve all existing translations
✓Only add new keys from code
✓Sort keys alphabetically
✓Show detailed statistics

📊

Google Sheets Integration

Team Collaboration

Sync translations with Google Sheets for team collaboration

📤Upload

npx i18n-upload \
  --spreadsheet-id "YOUR_ID" \
  --credentials "./credentials.json"

📥Download

npx i18n-download \
  --spreadsheet-id "YOUR_ID" \
  --credentials "./credentials.json"

⚙️Setup Required

Create Google Cloud Project
Enable Google Sheets API
Create Service Account
Download credentials JSON
Share Sheet with Service Account

Full Workflow

Wrap Korean Text

Automatically wrap hardcoded Korean strings in code

npx i18n-wrapper --pattern "app/**/*.tsx"

Key Extraction

Generate translation files from wrapped text

npx i18n-extractor -p "app/**/*.tsx" -d "./lib/translations"

Translation

Add English translations to en.json file

// lib/translations/en.json
{
  "환영합니다": "Welcome",
  "시작하기": "Get Started"
}

Sync with Sheets (Optional)

Upload to Google Sheets for team translation

npx i18n-upload --spreadsheet-id "YOUR_ID"

✓

Done!

Your app is now fully internationalized and ready to deploy