CLI

CLI ZhinNX bernama zz. Fungsinya mengurangi pekerjaan berulang dari setup, build, deploy config, dan debugging.

Status instalasi saat ini

Kalau ZhinNX sudah dipublish ke npm, install secara global.

npm install -g zhinnx@beta

Kalau kamu sedang mengetes ZIP source atau repository GitHub sebelum rilis npm, pakai CLI lokal.

cd zhinnx-cli
npm install --package-lock=false --no-audit --no-fund
node bin/zz.js --help
node bin/zz.js create my-app

Kamu juga bisa link command secara lokal.

chmod +x bin/zz.js
npm link
zz --help

Create

zz create my-app

Pembuatan project harus eksplisit. Command polos seperti zz my-app tidak didukung, jadi typo seperti zz crete akan menampilkan error dan help, bukan membuat folder tanpa sengaja.

Create dengan template

zz create my-app --template landing
zz create my-app --template dashboard
zz create my-app --template music-app
zz create my-app --template admin

Baca panduan template untuk melihat semua template.

Create dengan target deploy

zz create my-app --vercel
zz create my-app --netlify
zz create my-app --vercel --netlify

Flag ini membuat config provider saat project dibuat. Baca panduan deployment untuk memahami file yang digenerate.

Jalankan project hasil generate

cd my-app
npm install --package-lock=false --no-audit --no-fund
npm run dev

Build

zz build

Command build menghasilkan output static yang bisa dijalankan di Vercel, Netlify, atau static hosting lain.

Update config deploy

zz update --vercel
zz update --netlify
zz update --all

Pakai ini setelah mengubah setting project atau menambah target deploy.

Deploy

zz deploy --vercel
zz deploy --netlify
zz deploy --all

Command deploy membungkus provider CLI. Kamu tetap membutuhkan autentikasi dari Vercel atau Netlify. Kalau autentikasi gagal, jalankan login CLI provider lebih dulu.

Migrasi React + Vite

zz migrate react --syntax=jsx
zz migrate react --syntax=tsx --vercel --netlify

Migrasi memperbarui script package.json, menambahkan zhinnx@beta ke devDependencies, membuat zz.config.json, dan tidak menulis ulang source React kamu. Setelah migrasi, jalankan:

npm install --package-lock=false --no-audit --no-fund
npm run dev

Untuk build production di Vercel atau Netlify, zhinnx wajib ada di dependency project karena hosting menjalankan npm run build di environment bersih.

Debug

zz dev --debug

Command ini menjalankan dev server dengan debug overlay aktif. Fitur ini membantu melihat current route, registered pages, state, action call, API request, dan error terakhir.

Fallback aman

Kalau command zz belum tersedia, jalankan CLI lewat Node.

node bin/zz.js create my-app --template landing
node bin/zz.js build
node bin/zz.js dev --debug