Saturday, 17 January 2026

Publish npm package

 Để publish 

pav-kit
 lên NPM, bạn hãy làm theo các bước dưới đây. Tôi đã tạo thêm file 
index.js
 để đảm bảo gói tin hợp lệ.

Bước 1: Tạo tài khoản NPM (Nếu chưa có)

  1. Truy cập: https://www.npmjs.com/signup
  2. Điền Username, Email và Password.
  3. Vào email xác nhận tài khoản (rất quan trọng, nếu không xác nhận sẽ không publish được).

Bước 2: Đăng nhập NPM trên Terminal

Tại thư mục dự án (

/Users/phongle/sources/pascalia/pav-kit
), chạy lệnh:

bash
npm login
  • Nó sẽ mở trình duyệt để bạn đăng nhập.
  • Sau khi đăng nhập xong trên web, quay lại terminal, nó sẽ báo "Logged in as...".

Bước 3: Kiểm tra tên Package

Tên hiện tại trong 

package.json
 là 
pav-kit
. Bạn cần chắc chắn tên này chưa có ai dùng. Chạy lệnh này để kiểm tra:

bash
npm view pav-kit
  • Nếu báo 
    404 Not Found
     => ✅ Tên hợp lệ, chưa ai dùng.
  • Nếu hiện ra thông tin package khác => ❌ Đã có người dùng. Bạn cần sửa 
    name
     trong 
    package.json
     thành tên khác (ví dụ 
    pav-kit-cli
    pav-kit-core
    , hoặc 
    pascalia-pav-kit
    ).

Bước 4: Publish Package

Sau khi đã đăng nhập và chốt tên, chạy lệnh sau để publish:

bash
npm publish --access public

(Cờ 

--access public
 đảm bảo package được công khai, cần thiết nếu bạn dùng tên scoped dạng 
@username/package
, nhưng dùng luôn cho package thường cũng không sao).

Bước 5: Kiểm tra kết quả

Sau khi lệnh chạy xong (báo 

+ pav-kit@1.0.0
), bạn có thể thử ngay:

  1. Vào một thư mục khác (ví dụ 
    cd ~/Desktop
    ).
  2. Chạy thử cài đặt:
    bash
    npm install pav-kit
    # Hoặc chạy trực tiếp
    npx pav-kit init

Lưu ý quan trọng:

  • Cập nhật version: Mỗi lần bạn sửa code và muốn publish bản mới, bạn BẮT BUỘC phải tăng số version trong 
    package.json
     (ví dụ từ 
    1.0.0
     lên 
    1.0.1
    ).
  • Lệnh tăng version nhanh:
    bash
    npm version patch # 1.0.0 -> 1.0.1
    npm version minor # 1.0.0 -> 1.1.0
    npm version major # 1.0.0 -> 2.0.0
  • Sau đó chạy lại 
    npm publish
    .

Publish npm package

  Để publish   pav-kit  lên NPM, bạn hãy làm theo các bước dưới đây. Tôi đã tạo thêm file  index.js  để đảm bảo gói tin hợp lệ. Bước 1: Tạo ...