https://github.com/baimohui/i18n-mage

🪄 Wave your i18n wand. Conjure order from the chaos with auto-translation, smart fixes, and Excel sync.
https://github.com/baimohui/i18n-mage

automation frontend i18n i18next internationalization l10n localization productivity react react-i18next translation translation-management typescript vscode-extension vue vue-i18n

Last synced: 13 days ago
JSON representation

🪄 Wave your i18n wand. Conjure order from the chaos with auto-translation, smart fixes, and Excel sync.

• Host: GitHub
• URL: https://github.com/baimohui/i18n-mage
• Owner: baimohui
• License: mit
• Created: 2024-08-11T10:23:18.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2026-01-31T07:15:03.000Z (about 2 months ago)
• Last Synced: 2026-01-31T20:22:23.258Z (about 2 months ago)
• Topics: automation, frontend, i18n, i18next, internationalization, l10n, localization, productivity, react, react-i18next, translation, translation-management, typescript, vscode-extension, vue, vue-i18n
• Language: TypeScript
• Homepage:
• Size: 5.25 MB
• Stars: 17
• Watchers: 1
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
i18n Mage




  English | 简体中文





  Streamline your frontend i18n workflow with Vue I18n & React i18next support, auto-completion, inline hints, and Excel import/export.





  

    

  

  

    

  

  

    

  

  

    

  

  

    

  

  

    

  



---

## ✨ Features

### 🌳 Translation Tree Overview

* Displays an overview panel via the VS Code sidebar.

* Includes statistics (total keys, missing translations, etc.).

* Sync status per language file.

* Tree-structured view of translation entries.

* Functional buttons: Search, Export, Import, Sort, Fix.

![Tree Provider](https://raw.githubusercontent.com/baimohui/i18n-mage-docs/refs/heads/main/docs/en/guide/images/panel-view.png)

### 🧠 Inline Translation Hints

* Show actual translation inline where `t()` is used.

* Supports custom styles (color, max length, etc.).

* Toggleable via shortcuts.

![Inline Hints](https://raw.githubusercontent.com/baimohui/i18n-mage-docs/refs/heads/main/docs/en/guide/images/inline-hints.gif)

### ⚡ Intelligent Code Completion

* Automatically suggests existing translation entries when typing internationalization functions (e.g., `t("...")`)

* Supports candidate filtering by key, value, or bidirectional matching

* Auto-fills translation keys to boost multilingual development efficiency

![Code Completion](https://raw.githubusercontent.com/baimohui/i18n-mage-docs/refs/heads/main/docs/en/guide/images/completion.gif)

### 🚧 Auto-Fill Missing Translations

- Integrates global providers (DeepL, Google, OpenAI/ChatGPT) and optional regional providers (DeepSeek, Baidu, Tencent, Youdao)

- Fill missing translations automatically with preview and manual review

![Auto-Fill Missing Translations](https://raw.githubusercontent.com/baimohui/i18n-mage-docs/refs/heads/main/docs/en/guide/images/fill-missing-translations.gif)

### 🧹 Auto-Fix Undefined Entries

- Detect undefined entries

- Match existing entries or extract text into new entries

- Support customizable key naming strategies

![Auto-Fix Undefined Entries](https://raw.githubusercontent.com/baimohui/i18n-mage-docs/refs/heads/main/docs/en/guide/images/fix-undefined-entries.gif)

### 🛄 Extract Hardcoded Texts

- Scan hardcoded texts and batch-extract them into i18n keys

- Replace source code and write back into language files

- Preview before apply, suitable for migrating legacy projects

![Extract Hardcoded Texts](https://raw.githubusercontent.com/baimohui/i18n-mage-docs/refs/heads/main/docs/en/guide/images/extract-hardcoded-text.gif)

### 🕵️ Detect Unused Keys

* Analyzes usage of all keys.

* Pattern matching for dynamic keys.

* Delete or mark as used manually.

![Detect Unused Keys](https://raw.githubusercontent.com/baimohui/i18n-mage-docs/refs/heads/main/docs/en/guide/images/check-usage.gif)

### 🔍 Search Translation Entries

- Search across languages to locate target entries quickly

- Support whole-word and case-sensitive search

![Search Translation Entries](https://raw.githubusercontent.com/baimohui/i18n-mage-docs/refs/heads/main/docs/en/guide/images/search.gif)

### 📊 Excel Import/Export

- Export entries to Excel for translation teams

- Import translations from Excel and write back automatically

- Export git-based diff sheets (ADD/MODIFY/DELETE)

- Import diff sheets back into project

![Excel Import/Export](https://raw.githubusercontent.com/baimohui/i18n-mage-docs/refs/heads/main/docs/en/guide/images/excel.png)

### 📋 Cross-Project Entry Migration

- Copy entries by file or prefix into clipboard

- Paste copied entries into target projects for fast migration

![Copy Translation Data](https://raw.githubusercontent.com/baimohui/i18n-mage-docs/refs/heads/main/docs/en/guide/images/copy-entries.gif)

### Write Sorting

- Sort by key name or first occurrence position

- Reduce noisy diffs after fixes

![Sorting](https://raw.githubusercontent.com/baimohui/i18n-mage-docs/refs/heads/main/docs/en/guide/images/sorting.gif)

## ⚡ Quick Start

### 1. Install the Extension

**Option 1: Install from VS Code**

1. Open VS Code and go to Extensions (`Ctrl+Shift+X` / `Cmd+Shift+X`)

2. Search for `i18n Mage`

3. Click **Install**

**Option 2: Command Line Installation**

```bash

ext install jensen-wen.i18n-mage

```

**Option 3: Manual Installation**  

Visit the [Marketplace Page](https://marketplace.visualstudio.com/items?itemName=jensen-wen.i18n-mage) to install.

### 2. Open Translation Panel

- The extension automatically scans your project's i18n directory after activation

- Click the i18n Mage icon in the sidebar to open the translation panel

- Right-click in the panel to manually set translation directory if not auto-detected

### 3. Set Languages

- Right-click to configure display and source languages

- Manually assign languages to files if automatic detection fails

### 4. Configure Translation Services (Optional)

- Supported services: DeepL, Google, DeepSeek, Baidu, Tencent

- Configuration path: `Settings → Extensions → i18n Mage → Translation Services`

## 🧰 Configuration

### 🚀 Key Categories

* General settings

* Framework support (e.g. translation function names, interpolation)

* Translation services (API keys, reference language)

* Analysis rules (file scanning, auto detection)

* Write rules (key style, quote style, indentation)

* Inline hint styling

* Workspace-specific settings

> All settings are accessible via the VS Code Settings UI or in `.vscode/settings.json`.

## 🤝 Contributing

```bash

git clone https://github.com/baimohui/i18n-mage.git

cd i18n-mage

npm install

# f5 to debug

npm run check

npm run build

```

Feel free to submit issues or PRs!

## 📄 License

MIT License © 2024-2025 Jensen Wen