Giao diện
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ản | Ghi chú |
|---|---|---|
| Node.js | ^22.19.0 || ^24.11.0 || >=26.0.0 | Khai trong engines của app sinh từ CLI |
| pnpm | 11.x | Không cài tay — bật corepack, pnpm tự khớp bản ghim trong packageManager |
| Git | bấ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ự ánDù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 versionIn 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ượng | Nguyên nhân | Cá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ác | Xoá 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ữa | Xoá dòng token cũ |
ERR_PNPM_IGNORED_BUILDS | pnpm 11 chặn build script của dependency cho tới khi có quyết định tường minh | Ché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 TypeScript | Dự án chưa cài @tasco-fe/ui | Thêm @tasco-fe/ui vào dependencies (layer không re-export type) |
Tiếp theo
- Dự án mới → Tạo app mới.
- Dự án đã có → Thêm vào dự án có sẵn.