Skip to content

Chuẩn bị môi trường ​

Làm một lần cho mỗi máy. Sau bước này, mọi dự án Tasco trên máy đều cài được @tasco-fe/* từ npmjs.org.

1. Node và pnpm ​

Công cụPhiên bảnGhi chú
Node.js^22.19.0 || ^24.11.0 || >=26.0.0Khai trong engines của app sinh từ CLI
pnpm11.xKhông cài tay — bật corepack, pnpm tự khớp bản ghim trong packageManager
Gitbất kỳ
bash
node -v          # phải nằm trong dải trên
corepack enable  # pnpm dùng đúng bản ghim ở packageManager của từng dự án

Dùng npm hay yarn vẫn chạy, nhưng mọi tài liệu, script và CI mẫu đều viết theo pnpm.

2. Registry ​

Package @tasco-fe/* công khai trên npmjs.org: không cần token và không cần .npmrc riêng. App tạo bằng CLI có sẵn .npmrc chỉ gồm cài đặt pnpm (auto-install-peers=true).

Còn dùng bản 2.x (@tasco/*)?

Bản 2.x nằm ở GitLab Package Registry nội bộ, cần Deploy Token read_package_registry và .npmrc trỏ registry đó (hỏi team core). Hướng dẫn ở Cấu hình .npmrc; nâng lên 3.0 theo Migration.

3. Kiểm tra ​

bash
npm view @tasco-fe/nuxt-layer-base version

In ra số phiên bản là xong. Gặp lỗi thì tra bảng dưới.

Lỗi thường gặp ​

Hiện tượngNguyên nhânCách sửa
404 Not Found khi cài @tasco-fe/*Gõ sai tên package, hoặc .npmrc còn dòng @tasco-fe:registry trỏ nơi khácXoá dòng registry thừa; kiểm tra bằng npm view @tasco-fe/ui version
401 Unauthorized.npmrc hoặc ~/.npmrc còn _authToken cũ trỏ registry không dùng nữaXoá dòng token cũ
ERR_PNPM_IGNORED_BUILDSpnpm 11 chặn build script của dependency cho tới khi có quyết định tường minhChép khối allowBuilds trong pnpm-workspace.yaml của template CLI, hoặc chạy pnpm approve-builds
Cài xong nhưng thiếu kiểu TypeScriptDự án chưa cài @tasco-fe/uiThêm @tasco-fe/ui vào dependencies (layer không re-export type)

Tiếp theo ​