@tufarm/utils

Shared utilities package for TuFarm applications (Admin Panel, Backend Base, Mini App).

Setup & Publishing to GitHub Packages

1. Authenticate with GitHub Packages

You need a GitHub Personal Access Token (PAT) with write:packages and read:packages permissions.

Create or update your ~/.npmrc file with the following content:

//npm.pkg.github.com/:_authToken=YOUR_GITHUB_PAT
@tufarm:registry=https://npm.pkg.github.com

2. Phát hành phiên bản mới lên NPM & Đồng bộ cả 3 dự án (Khuyên Dùng)

Chỉ cần chạy 1 lệnh duy nhất từ thư mục gốc hoặc trong tufarm-utils:

# Từ thư mục gốc của Monorepo:
./deploy-utils.sh          # Tự động: build -> tăng patch version -> publish NPM -> update package.json -> sync node_modules -> update lockfile song song

# Hoặc từ bên trong thư mục tufarm-utils:
yarn release               # Tăng patch (VD: 1.0.11 -> 1.0.12)
yarn release minor         # Tăng minor (VD: 1.0.11 -> 1.1.0)
yarn release:quick         # Publish NPM + sync ngay, bỏ qua bước chờ update lockfile

3. Đồng bộ cục bộ tức thì khi đang Dev/Test (Không cần Publish NPM)

Nếu đang code tính năng hoặc test Mini App / Admin ở local và muốn ăn code ngay lập tức (trong 1 giây):

# Từ thư mục gốc:
./deploy-utils.sh --sync-only

# Hoặc từ tufarm-utils:
yarn sync

Lệnh này sẽ compile tsup và copy trực tiếp thư mục dist/ vào node_modules của cả 3 dự án. Vite và Nodemon sẽ nhận code mới ngay lập tức mà không cần kết nối mạng hay publish NPM.