Inicjalizacja Intlayer

npx intlayer init

Polecenie init instaluje pakiety Intlayer i konfiguruje Twój framework (plik konfiguracyjny, TypeScript, plugin bundlera, middleware/proxy, providery). To zalecany sposób na rozpoczęcie pracy z Intlayer.

Wszystko inne (workflowy CI, skille AI, serwer MCP, narzędzia edytora, reguły lintera, CMS, infrastruktura) jest opcjonalne: wybierz to z listy --interactive albo uruchom odpowiednie polecenie (zobacz niżej).

Aliase:

• npx intlayer init

Argumenty:

• --project-root [projectRoot] - Opcjonalnie. Określ katalog główny projektu. Jeśli nie zostanie podany, polecenie będzie szukać katalogu głównego projektu zaczynając od bieżącego katalogu roboczego.
• --no-gitignore - Opcjonalnie. Pomija automatyczną aktualizację pliku .gitignore. Jeśli ta flaga jest ustawiona, .intlayer nie zostanie dodany do .gitignore.
• --no-framework-setup - Opcjonalne. Tylko instaluje pakiety, bez zmieniania plików projektu.
• --routing <routing> - Opcjonalne. Routing lokalizacji: prefix-no-default (domyślnie), prefix-all, no-prefix, search-params lub none.
• -i, --interactive - Opcjonalne. Wybierz kroki z listy (pakiety, CI, skille, MCP, VS Code, LSP, lint, CMS, infrastruktura, …) zamiast domyślnego zestawu. Wymaga terminala: bez niego (agent AI, CI) polecenie kończy się błędem i wypisuje polecenia do uruchomienia zamiast niego.
• --no-github-actions - Opcjonalne. Z --interactive nigdy nie tworzy workflowów GitHub Actions, nawet jeśli są zaznaczone.

Co to robi:

Polecenie init wykonuje następujące zadania konfiguracyjne:

1. Waliduje strukturę projektu - Upewnia się, że znajdujesz się w prawidłowym katalogu projektu z plikiem package.json.
2. Instaluje pakiety - Instaluje brakujące pakiety Intlayer dla Twojego stosu (np. react-intlayer, vite-intlayer) i aktualizuje nieaktualne.
3. Aktualizuje .gitignore - Dodaje .intlayer do pliku .gitignore, aby wykluczyć wygenerowane pliki z kontroli wersji (można pominąć za pomocą --no-gitignore).
4. Konfiguruje TypeScript - Aktualizuje pliki tsconfig.json, aby zawierały definicje typów Intlayer (.intlayer/**/*.ts).
5. Tworzy plik konfiguracyjny - Generuje intlayer.config.ts (dla projektów TypeScript) lub intlayer.config.mjs (dla projektów JavaScript) z domyślnymi ustawieniami.
6. Aktualizuje konfigurację bundlera / frameworka - Dodaje plugin Intlayer do konfiguracji Vite, Next.js, Nuxt, Astro, … i tworzy middleware/proxy oraz providery, gdy framework to obsługuje.

Konfiguracja krok po kroku

Każdy krok listy --interactive ma własne polecenie. Nie zadają pytań, gdy wartości są przekazane jako flagi, więc można je bezpiecznie uruchamiać z agenta AI lub zadania CI.

Z agenta AI lub zadania CI

Powłoka agenta AI nie ma terminala, więc nie da się odpowiedzieć na pytanie. Użyj domyślnego polecenia, a potem potrzebnych poleceń:

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

Bez terminala:

• init skills instaluje skille pasujące do Twojego stosu, chyba że ustawiono --skills (np. --skills Usage Content React).
• init skills i init mcp używają wykrytej platformy AI (Claude Code, Cursor, VS Code, Windsurf, …), chyba że ustawiono --platform, i kończą się błędem z listą platform, gdy żadna nie zostanie wykryta.
• init mcp używa transportu stdio, chyba że ustawiono --transport.
• init infra wymaga --mode, a init extension tylko wypisuje linki do sklepu, chyba że ustawiono --browser.

Serwer MCP jest zawsze konfigurowany wewnątrz projektu (dla Claude Code w .mcp.json).

Przykłady:

Podstawowa inicjalizacja:

npx intlayer init

Inicjuje Intlayer w bieżącym katalogu, automatycznie wykrywając katalog główny projektu.

Inicjalizacja z niestandardowym katalogiem głównym projektu:

npx intlayer init --project-root ./moj-projekt

Inicjuje Intlayer we wskazanym katalogu.

Inicjalizacja bez aktualizacji .gitignore:

npx intlayer init --no-gitignore

Konfiguruje wszystkie pliki konfiguracyjne, ale nie modyfikuje pliku .gitignore.

Skonfiguruj infrastrukturę (aplikacja desktopowa lub self-hosting):

npx intlayer init infra

Pobiera i uruchamia instalator (https://intlayer.org/install.sh, lub install.ps1 w systemie Windows), który pyta, jak chcesz uruchomić Intlayer:

• Aplikacja desktopowa - instaluje natywny pulpit nawigacyjny na Twoim komputerze, połączony z Intlayer Cloud.
• All-in-one Docker - pulpit nawigacyjny + API + MongoDB + Redis + MinIO w pojedynczym kontenerze.
• Docker Compose - jeden kontener na usługę, dla skalowalnego self-hostingu.

Pomiń menu za pomocą --mode:

npx intlayer init infra --mode compose

Ten sam krok jest oferowany przez npx intlayer init --interactive. Zobacz informacje o init infra dotyczące ustawień instalatora oraz przewodnik po self-hostingu, aby dowiedzieć się, co konfiguruje każdy tryb.

Przykładowy wynik:

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.

Uwagi:

• Polecenie jest idempotentne - możesz je bezpiecznie uruchamiać wielokrotnie. Już skonfigurowane kroki zostaną pominięte.
• Jeśli plik konfiguracyjny już istnieje, nie zostanie nadpisany.
• Konfiguracje TypeScript bez tablicy include (np. konfiguracje w stylu solution z referencjami) są pomijane.
• Polecenie zakończy się błędem, jeśli w katalogu głównym projektu nie zostanie znaleziony plik package.json.