Khởi tạo Intlayer

npx intlayer init

Lệnh init cài đặt các gói Intlayer và thiết lập framework của bạn (tệp cấu hình, TypeScript, plugin bundler, middleware/proxy, provider). Đây là cách được khuyến nghị để bắt đầu với Intlayer.

Mọi thứ khác (workflow CI, skill AI, máy chủ MCP, công cụ editor, quy tắc lint, CMS, hạ tầng) đều là tùy chọn: chọn trong checklist --interactive, hoặc chạy lệnh con tương ứng (xem bên dưới).

Tên thay thế (Aliases):

• npx intlayer init

Các tham số (Arguments):

• --project-root [projectRoot] - Tùy chọn. Chỉ định thư mục gốc của dự án. Nếu không được cung cấp, lệnh sẽ tìm kiếm thư mục dự án bắt đầu từ thư mục làm việc hiện tại.
• --no-gitignore - Tùy chọn. Bỏ qua việc tự động cập nhật tệp .gitignore. Nếu cờ này được đặt, .intlayer sẽ không được thêm vào .gitignore.
• --no-framework-setup - Tùy chọn. Chỉ cài đặt các gói, không thay đổi các tệp của dự án.
• --routing <routing> - Tùy chọn. Định tuyến locale: prefix-no-default (mặc định), prefix-all, no-prefix, search-params hoặc none.
• -i, --interactive - Tùy chọn. Chọn các bước thiết lập từ một checklist (gói, CI, skill, MCP, VS Code, LSP, lint, CMS, hạ tầng, …) thay vì bộ mặc định. Cần có terminal: nếu không có (agent AI, CI), lệnh sẽ thất bại và liệt kê các lệnh con cần chạy thay thế.
• --no-github-actions - Tùy chọn. Với --interactive, không bao giờ tạo các workflow GitHub Actions, kể cả khi chúng được chọn.

Cách thức hoạt động:

Lệnh init thực hiện các tác vụ thiết lập sau:

1. Xác thực cấu trúc dự án - Đảm bảo bạn đang ở trong một thư mục dự án hợp lệ có tệp package.json.
2. Cài đặt các gói - Cài đặt các gói Intlayer còn thiếu cho stack của bạn (ví dụ react-intlayer, vite-intlayer) và nâng cấp các gói đã cũ.
3. Cập nhật .gitignore - Thêm .intlayer vào tệp .gitignore của bạn để loại bỏ các tệp được tạo tự động khỏi trình quản lý phiên bản (có thể bỏ qua bằng --no-gitignore).
4. Cấu hình TypeScript - Cập nhật bất kỳ tệp tsconfig.json nào để bao gồm các định nghĩa kiểu của Intlayer (.intlayer/**/*.ts).
5. Tạo tệp cấu hình - Tạo intlayer.config.ts (cho các dự án TypeScript) hoặc intlayer.config.mjs (cho các dự án JavaScript) với các cài đặt mặc định.
6. Cập nhật cấu hình bundler / framework - Thêm plugin Intlayer vào cấu hình Vite, Next.js, Nuxt, Astro, … và tạo middleware/proxy cùng provider khi framework hỗ trợ.

Thiết lập từng bước một

Mỗi bước trong checklist --interactive đều có lệnh con riêng. Chúng không hỏi gì khi các giá trị được truyền dưới dạng flag, nên có thể chạy an toàn từ agent AI hoặc job CI.

Từ agent AI hoặc job CI

Shell của agent AI không có terminal, nên không thể trả lời câu hỏi. Hãy dùng lệnh mặc định, sau đó là các lệnh con bạn cần:

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

Khi không có terminal:

• init skills cài đặt các skill phù hợp với stack của bạn, trừ khi đặt --skills (ví dụ --skills Usage Content React).
• init skills và init mcp dùng nền tảng AI được phát hiện (Claude Code, Cursor, VS Code, Windsurf, …), trừ khi đặt --platform, và thất bại kèm danh sách nền tảng nếu không phát hiện được nền tảng nào.
• init mcp dùng transport stdio, trừ khi đặt --transport.
• init infra bắt buộc có --mode, còn init extension chỉ in ra các liên kết cửa hàng, trừ khi đặt --browser.

Máy chủ MCP luôn được cấu hình bên trong dự án (với Claude Code là trong .mcp.json).

Ví dụ:

Khởi tạo cơ bản:

npx intlayer init

Thao tác này khởi tạo Intlayer trong thư mục hiện tại, tự động phát hiện gốc dự án.

Khởi tạo với gốc dự án tùy chỉnh:

npx intlayer init --project-root ./du-an-cua-toi

Thao tác này khởi tạo Intlayer trong thư mục được chỉ định.

Khởi tạo không cập nhật .gitignore:

npx intlayer init --no-gitignore

Thao tác này sẽ thiết lập tất cả các tệp cấu hình nhưng sẽ không sửa đổi tệp .gitignore của bạn.

Thiết lập cơ sở hạ tầng (ứng dụng máy tính để bàn hoặc tự lưu trữ):

npx intlayer init infra

Tải xuống và chạy trình cài đặt được lưu trữ (https://intlayer.org/install.sh, hoặc install.ps1 trên Windows), hỏi bạn cách muốn chạy Intlayer:

• Ứng dụng máy tính để bàn - cài đặt bảng điều khiển gốc trên máy của bạn, kết nối với Intlayer Cloud.
• Docker tất cả trong một (All-in-one) - bảng điều khiển + API + MongoDB + Redis + MinIO trong một vùng chứa duy nhất.
• Docker Compose - một vùng chứa cho mỗi dịch vụ, để tự lưu trữ có thể mở rộng.

Bỏ qua menu với --mode:

npx intlayer init infra --mode compose

Bước tương tự cũng được cung cấp bởi npx intlayer init --interactive. Xem tài liệu tham khảo init infra để biết cài đặt của trình cài đặt và hướng dẫn tự lưu trữ để biết những gì mỗi chế độ thiết lập.

Ví dụ đầu ra:

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.

Lưu ý:

• Lệnh này mang tính lũy đẳng (idempotent) - bạn có thể chạy nó nhiều lần một cách an toàn. Các bước đã được cấu hình sẽ tự động được bỏ qua.
• Nếu tệp cấu hình đã tồn tại, nó sẽ không bị ghi đè.
• Các cấu hình TypeScript không có mảng include (ví dụ: cấu hình kiểu giải pháp có tham chiếu) sẽ bị bỏ qua.
• Lệnh sẽ dừng với thông báo lỗi nếu không tìm thấy package.json trong gốc dự án.