@cond/i18n-editor/README.md

A web-based i18n translation editor to manage locale files easily.

# i18n Editor

A simple web-based tool to manage translation files efficiently.

## Features
✅ **Edit and manage locale files in your browser**
✅ **Supports JSON-based translation files**
✅ **Automatically updates or adds new translation keys**
✅ **Lightweight and easy to use**
✅ **No command-line setup required**
✅ **Starts on a random available port**
✅ **Supports custom locales directory (default: `locales/`)**

## Installation

### 1️⃣ Install via npm
```sh
npm install -g i18n-editor
```

### 2️⃣ Run the Web Interface
```sh
i18n-editor [--locales <directory>]
```
This will start a local web server on a **random available port** and open the editor in your default browser.

### Example with a Custom Locales Directory
```sh
i18n-editor --locales my-translations/
```
By default, the tool looks for locale files in the `locales/` directory.

## Usage
1. The tool will automatically open in your browser.
2. View and edit all translations in a structured table.
3. Click on a translation field to modify its value.
4. Changes are saved automatically.

## Folder Structure
```
📂 project-root
 ├── 📂 locales            # Default JSON translation files
 │   ├── en.json
 │   ├── fr.json
 │   └── es.json
 ├── package.json          # Project dependencies
 ├── README.md             # Documentation
```

## Contributing
Feel free to open a PR if you’d like to improve the tool! 🚀

## License
MIT License