# Intlayer AI Site (`ai.intlayer.org`)

Landing page and web showcase for [ai.intlayer.org](https://ai.intlayer.org) — highlighting **Intlayer**'s AI-powered internationalization (i18n), dynamic content generation, A/B testing, and AI-driven translation workflows.

---

## 🌟 About Intlayer

[Intlayer](https://intlayer.org) is an open-source, modern internationalization (i18n) framework designed for JavaScript and TypeScript applications (React, Next.js, Vite, Vue, Svelte, Express, and more). Beyond traditional key-value dictionaries, Intlayer treats content declaration as code and integrates AI tools to streamline localization, translation maintenance, and content auditing.

Explore the live AI landing page at [ai.intlayer.org](https://ai.intlayer.org).

---

## 🤖 Intlayer AI CLI Tools

Intlayer provides powerful CLI commands driven by AI models (OpenAI, Anthropic, Mistral, Google Gemini, Ollama, etc.) to automate and maintain translations across codebases and documentation.

### 1. `intlayer fill` — AI Dictionary Audit & Fill

The [`intlayer fill`](https://intlayer.org/doc/concept/cli/fill) command inspects your content declaration files (`*.content.{ts,js,tsx,jsx,json}`) for missing translations, structural inconsistencies, or type discrepancies. It automatically uses AI to complete missing locales while preserving existing keys and context.

```bash
# Audit and automatically fill missing translations in all dictionaries
npx intlayer fill

# Target specific content declaration files
npx intlayer fill -f src/components/Hero.content.ts

# Target specific dictionary keys
npx intlayer fill -k heroSection navbar

# Choose a specific AI provider and model
npx intlayer fill --provider openai --model gpt-4o
```

**Key Features:**
- **Smart Chunking:** Automatically divides large JSON/content files into manageable blocks to stay within token context limits.
- **Context-Aware:** Incorporates surrounding application and file context for natural, idiomatic translations.
- **Non-Destructive:** Retains existing translations and only updates missing or mismatched fields.
- **Parallel Processing:** Uses concurrent queues across files and locales to optimize speed.

📖 [Read the full `intlayer fill` documentation](https://intlayer.org/doc/concept/cli/fill)

---

### 2. `intlayer doc translate` — AI Documentation Translation

The [`intlayer doc translate`](https://intlayer.org/doc/concept/cli/doc-translate) command automatically translates markdown and MDX documentation files from a base locale to target locales using AI models.

```bash
# Translate docs matching a pattern to specific locales
npx intlayer doc translate --doc-pattern "docs/**/*.md" --base-locale en --locales fr es de

# Skip files that have not changed recently
npx intlayer doc translate --skip-if-exists

# Run with custom concurrency
npx intlayer doc translate --nb-simultaneous-file-processed 4
```

**Key Features:**
- **Markdown & MDX Aware:** Preserves frontmatter, code blocks, and markdown structure during translation.
- **Large Document Chunking:** Splits lengthy guides and documentation into coherent chunks.
- **Configurable Locales:** Explicitly control source and target locales or rely on your `intlayer.config.ts`.

📖 [Read the full `intlayer doc translate` documentation](https://intlayer.org/doc/concept/cli/doc-translate)

---

### 3. `intlayer doc review` — Documentation Quality & Sync Audit

The [`intlayer doc review`](https://intlayer.org/doc/concept/cli/doc-review) command checks translated documentation against the source base documentation to ensure consistency, find diverging sections, and apply fixes.

```bash
# Review existing translated docs and apply AI updates to outdated sections
npx intlayer doc review --doc-pattern "docs/**/*.md" --base-locale en --locales fr es

# Generate a report of diverging blocks without modifying files
npx intlayer doc review --mode report

# Display only the high-level status synthesis
npx intlayer doc review --mode synthesis
```

**Modes:**
- `apply` *(default)*: Analyzes diverging sections with AI, updates out-of-sync blocks, and writes the translated files.
- `report`: Runs a dry run without calling AI translation APIs; logs out-of-date blocks with line numbers for manual or agentic review.
- `synthesis`: Skips block-level logging and prints an executive summary of up-to-date and pending files.

📖 [Read the full `intlayer doc review` documentation](https://intlayer.org/doc/concept/cli/doc-review)

---

## 🚀 Running This Website Locally

This repository contains the static deployment of [ai.intlayer.org](https://ai.intlayer.org) served with Nginx via Docker.

### Prerequisites

- [Docker](https://www.docker.com/) installed on your machine.

### Build and Run

1. **Build the Docker container:**
   ```bash
   docker build -t intlayer-ai -f ./Dockerfile .
   ```

2. **Run the container:**
   ```bash
   docker run --rm -p 8000:80 --name intlayer-ai-app intlayer-ai
   ```

3. Open your browser and navigate to `http://localhost:8000`.

---

## 🔗 Useful Links

- **Website:** [ai.intlayer.org](https://ai.intlayer.org)
- **Official Intlayer Website:** [intlayer.org](https://intlayer.org)
- **CLI Fill Guide:** [intlayer.org/doc/concept/cli/fill](https://intlayer.org/doc/concept/cli/fill)
- **CLI Doc Translate Guide:** [intlayer.org/doc/concept/cli/doc-translate](https://intlayer.org/doc/concept/cli/doc-translate)
- **CLI Doc Review Guide:** [intlayer.org/doc/concept/cli/doc-review](https://intlayer.org/doc/concept/cli/doc-review)
- **GitHub Repository:** [github.com/aymericzip/intlayer](https://github.com/aymericzip/intlayer)