CLI Nxdom
Nxdom Framework — Nusantara eXtreme Development Object Model. Satu halaman untuk memasang CLI dari npm, membuat proyek, migrasi database, generator controller, dan server pengembangan.
Instalasi (npm global)
Pasang sekali di mesin (Node.js 18+). Setelah itu perintah nxdom tersedia di folder mana pun.
npm install -g nxdom-cli
nxdom help
npm ls -g nxdom-cli
Baris npm ls -g nxdom-cli harus menampilkan versi (mis. nxdom-cli@1.0.8)
tanpa panah -> ke folder lokal — itu berarti masih npm link (development), bukan paket dari npmjs.
Tanpa install global (sekali jalan):
npx nxdom-cli create web my-sitePersyaratan
| Tool | Untuk |
|---|---|
| Node.js 18+ & npm | Menjalankan CLI |
| Git atau mode ZIP | Unduh template (create) |
| PHP + Composer | Proyek create app |
| npm | Proyek create node / react / electron |
Mulai cepat
nxdom create web my-site
cd my-site
nxdom modulesnxdom create — proyek baru
Semua template diambil dari branch main repo Nxadom/framework.
| Perintah | Folder di GitHub | Install otomatis | Keterangan |
|---|---|---|---|
create app [nama] | backend/ | composer install | API/backend PHP NexaUI |
create web [nama] | web/ | — | Frontend statis (HTML/JS) |
create node [nama] | node/ | npm install | Server Express |
create express [nama] | node/ | npm install | Alias create node |
create electron [nama] | eletron/ | npm install | Desktop Electron |
create desktop [nama] | eletron/ | npm install | Alias create electron |
create react [nama] | react/ | npm install | React / Expo |
create mobile [nama] | react/ | npm install | Alias create react |
Opsi umum:
-d, --dir <path>— folder induk tempat proyek dibuat--no-composer/--no-npm— lewati install otomatis
nxdom create app my-api -d ./apps
nxdom create electron my-desktop
nxdom create react my-mobilenxdom modules
Memperbarui assets/modules dari repo GitHub (menghapus folder lama lalu mengganti).
Berlaku di proyek web, node, react, electron, dan backend setelah create.
cd my-site
nxdom modules
nxdom modules@v1.0.0
nxdom modules v1.0.0 -yPerintah di dalam proyek
Jalankan dari root proyek (folder hasil create app dengan system/bin/router.php),
atau gunakan -C / NXDOM_ROOT dari folder lain.
| Perintah | Fungsi |
|---|---|
nxdom migrate … | Migration database (backend) |
nxdom make … | Generator controller |
nxdom start / dev | Server PHP / mode dev |
nxdom install node | Setup server Node di proyek backend |
nxdom -C <folder> <cmd> | Jalankan perintah di root proyek tertentu |
nxdom -C ./apps/my-api migrate run
nxdom -C ./apps/my-api make 1/Product
nxdom -C ./apps/my-api start 8000nxdom migrate
Setelah proyek backend siap, jalankan migrasi agar skema database mengikuti framework.
cd my-api
nxdom migrate run
nxdom migrate rollback
nxdom migrate status
nxdom migrate create CreateProductsTable
nxdom migrate createdb nama_database
createdb membuat database MySQL (CREATE DATABASE IF NOT EXISTS) memakai
DB_HOST, DB_USERNAME, DB_PASSWORD dari .env,
lalu mengisi DB_DATABASE di .env.
Tanpa argumen → menu interaktif (opsi 5 = createdb).
nxdom make
Generator controller Admin. Prefiks 1 = area Admin; 1/Product → kelas seperti ProductController.
nxdom make 1/Product1/…→ Admin2/…→ Api3/…→ Frontend- Tanpa argumen → interaktif
nxdom start — server pengembangan
Menjalankan PHP built-in server memakai system/bin/router.php.
Direktori kerja = root proyek backend.
nxdom start
nxdom start 3000
nxdom start 8000 1Argumen kedua opsional: 1 = localhost, 2 = jaringan LAN (Windows).
Variabel lingkungan CLI
| Variabel | Default | Fungsi |
|---|---|---|
NXDOM_TEMPLATE_REPO | https://github.com/Nxadom/framework.git | Sumber create |
NXDOM_TEMPLATE_BRANCH | main | Branch template |
NXDOM_ROOT | — | Root proyek (sama seperti -C) |
NXDOM_CREATE_DOWNLOAD | git lalu ZIP | Set zip untuk unduh tanpa Git |
PHP_BIN | php | Perintah PHP |
NXDOM_NO_BANNER | — | 1 = sembunyikan banner di nxdom help |
Proyek lama: nxdom.bat di root repo
Beberapa proyek backend yang di-clone manual masih menyertakan nxdom.bat (Windows) atau skrip nxdom di root.
Itu setara perintah lokal di folder tersebut. Untuk proyek baru, disarankan
npm install -g nxdom-cli lalu nxdom create app … — tidak perlu mengandalkan nxdom.bat atau setup PowerShell profil.
npm install github:iyanrsaleh/nxdom di package.json — itu dependency Node, bukan pengganti npm install -g nxdom-cli.