Ініціалізація Intlayer

npx intlayer init

Команда init встановлює пакети Intlayer і налаштовує ваш фреймворк (файл конфігурації, TypeScript, плагін бандлера, middleware/proxy, провайдери). Це рекомендований спосіб почати роботу з Intlayer.

Усе інше (CI-воркфлоу, AI-скіли, MCP-сервер, інструменти редактора, правила лінтера, CMS, інфраструктура) вмикається за бажанням: виберіть це в чек-листі --interactive або запустіть окрему підкоманду (див. нижче).

Аліаси (Aliases):

• npx intlayer init

Аргументи (Arguments):

• --project-root [projectRoot] - Опціонально. Вкажіть кореневу директорію проєкту. Якщо не вказано, команда шукатиме корінь проєкту, починаючи з поточної робочої директорії.
• --no-gitignore - Опціонально. Пропускає автоматичне оновлення файлу .gitignore. Якщо цей прапорець встановлено, .intlayer не буде додано до .gitignore.
• --no-framework-setup - Необов'язково. Лише встановлює пакети, не змінюючи файли проєкту.
• --routing <routing> - Необов'язково. Маршрутизація локалей: prefix-no-default (за замовчуванням), prefix-all, no-prefix, search-params або none.
• -i, --interactive - Необов'язково. Виберіть кроки налаштування з чек-листа (пакети, CI, скіли, MCP, VS Code, LSP, лінтер, CMS, інфраструктура, …) замість набору за замовчуванням. Потрібен термінал: без нього (AI-агент, CI) команда завершується помилкою й виводить список підкоманд, які треба запустити натомість.
• --no-github-actions - Необов'язково. З --interactive ніколи не створює воркфлоу GitHub Actions, навіть якщо їх вибрано.

Що вона робить:

Команда init виконує наступні завдання з налаштування:

1. Перевірка структури проєкту - Переконується, що ви перебуваєте в коректній директорії проєкту з файлом package.json.
2. Встановлює пакети - Встановлює відсутні для вашого стеку пакети Intlayer (наприклад, react-intlayer, vite-intlayer) і оновлює застарілі.
3. Оновлення .gitignore - Додає .intlayer до вашого файлу .gitignore, щоб виключити згенеровані файли з системи контролю версій (можна пропустити за допомогою --no-gitignore).
4. Конфігурація TypeScript - Оновлює будь-які файли tsconfig.json, щоб включити визначення типів Intlayer (.intlayer/**/*.ts).
5. Створення файлу конфігурації - Генерує intlayer.config.ts (для проєктів на TypeScript) або intlayer.config.mjs (для проєктів на JavaScript) з налаштуваннями за замовчуванням.
6. Оновлює конфігурацію бандлера / фреймворка - Додає плагін Intlayer до конфігурації Vite, Next.js, Nuxt, Astro, …, і створює middleware/proxy та провайдери, якщо фреймворк це підтримує.

Налаштування по одному кроку

Кожен крок чек-листа --interactive має власну підкоманду. Вони нічого не питають, якщо значення передано прапорцями, тож їх можна безпечно запускати з AI-агента або CI-завдання.

З AI-агента або CI-завдання

Оболонка AI-агента не має термінала, тому відповісти на запитання неможливо. Використайте команду за замовчуванням, а потім потрібні підкоманди:

npx intlayer init
npx intlayer init skills --platform Claude
npx intlayer init mcp --platform Claude --transport stdio

Без термінала:

• init skills встановлює скіли, що відповідають вашому стеку, якщо не задано --skills (наприклад, --skills Usage Content React).
• init skills і init mcp використовують виявлену AI-платформу (Claude Code, Cursor, VS Code, Windsurf, …), якщо не задано --platform, і завершуються помилкою зі списком платформ, якщо жодну не виявлено.
• init mcp використовує транспорт stdio, якщо не задано --transport.
• init infra вимагає --mode, а init extension лише виводить посилання на магазин, якщо не задано --browser.

MCP-сервер завжди налаштовується всередині проєкту (для Claude Code у .mcp.json).

Приклади:

Базова ініціалізація:

npx intlayer init

Це ініціалізує Intlayer у поточній директорії з автоматичним визначенням кореня проєкту.

Ініціалізація з користувацьким коренем проєкту:

npx intlayer init --project-root ./my-project

Це ініціалізує Intlayer у вказаній директорії.

Ініціалізація без оновлення .gitignore:

npx intlayer init --no-gitignore

Це налаштує всі файли конфігурації, але не змінить ваш файл .gitignore.

Налаштування інфраструктури (десктопний застосунок або власний хостинг):

npx intlayer init infra

Завантажує та запускає інсталятор (https://intlayer.org/install.sh, або install.ps1 на Windows), який запитує, як ви хочете запускати Intlayer:

• Десктопний застосунок - встановлює нативну панель керування на ваш комп'ютер, підключену до Intlayer Cloud.
• All-in-one Docker - панель керування + API + MongoDB + Redis + MinIO в одному контейнері.
• Docker Compose - один контейнер на сервіс для масштабованого власного хостингу.

Пропустіть меню за допомогою --mode:

npx intlayer init infra --mode compose

Цей же крок пропонується через npx intlayer init --interactive. Дивіться довідку init infra щодо налаштувань інсталятора та посібник із власного хостингу щодо того, що налаштовує кожен режим.

Приклад виводу:

npx intlayer init
Checking Intlayer configuration...
✓ Added .intlayer to .gitignore
✓ Updated tsconfig.json to include intlayer types
✓ Created intlayer.config.ts
✓ Injected import into vite.config.ts
✓ Intlayer init setup complete.

Примітки:

• Команда є ідемпотентною - ви можете безпечно запускати її кілька разів. Вже налаштовані кроки будуть пропущені.
• Якщо файл конфігурації вже існує, він не буде перезаписаний.
• Конфігурації TypeScript без масиву include (наприклад, конфігурації у стилі solution з посиланнями) пропускаються.
• Команда зупиниться з помилкою, якщо в корені проєкту не буде знайдено package.json.