CLI Nxdom

Instalasi

Nxdom tersedia dalam dua distribusi. Pilih paket npm untuk lingkungan yang sudah memakai Node.js, atau EXE portabel untuk Windows tanpa instalasi Node.js.

Tool eksternal

Membuka nxdom

Masuk ke root proyek yang ingin dikelola, kemudian jalankan nxdom:

cd D:\path\ke\proyek
nxdom

Menu Runtime menyediakan tujuh bagian utama:

• Backend
• Modules
• Desktop
• Mobile
• Web (Express/Node)
• Web Statik
• Asisten

Navigasi terminal

Alur kerja umum

Module → Install → Config → Start → Log → Stop

Modul wajib per runtime

Nxdom memeriksa registry assets/modules/modules.json dan folder aktual sebelum memasang runtime. Modul wajib yang belum tersedia akan dipasang otomatis oleh alur Install, termasuk saat aksi dipicu melalui Asisten.

Backend

Rute: Runtime → Backend atau nxdom backend.

Install dan Reinstall

Install meminta nilai APP_ENV, APP_DEBUG, DB_DATABASE, DB_USERNAME, dan DB_PASSWORD. Jika Backend sudah ada, gunakan Reinstall agar konfigurasi database tidak ditulis ulang.

Update komponen Backend

Pengguna dapat memilih satu komponen atau seluruh komponen. Kebijakan Update adalah replace penuh untuk folder yang dipilih:

Path runtime System yang dipertahankan adalah system/Storage/menu_config.json, system/Storage/tabel/**, dan system/log/**. Update memakai staging dan backup sementara. Jika swap gagal, komponen yang sudah berubah dikembalikan otomatis.

Migrate, Make, Connection, dan Start

Migrate  run · rollback · status · create · createdb
Make     Admin · Api · Frontend → nama controller
Start    port default 8000 · Localhost / Network (0.0.0.0)

Modules

Rute: Runtime → Modules atau nxdom modules.

Modul disimpan di assets/modules. Setiap operasi memperbarui registry modules.json, loader modules.installed.js, barrel Mobile index.js, CSS gabungan nexa.css, dan loader nxdom.js sesuai kebutuhan.

Perintah Modules

nxdom modules
nxdom modules bootstrap
nxdom modules check
nxdom modules install <nama> --deps
nxdom modules uninstall <nama>
nxdom modules reinstall <nama>

Modul icons

Modul icons membuka pemilih set ikon. Pengguna dapat memilih seluruh set atau beberapa set lalu memilih Done. Uninstall dan Reinstall hanya menampilkan set yang sudah terpasang; menghapus satu set tidak menghapus set lainnya.

Struktur wajib dipertahankan: assets/modules/icons/<nama-set>/.... Loader bersama berada di assets/modules/icons/NexaIcons.js. Modul Mobile Icon berbeda dari paket umum icons.

Desktop

Rute: Runtime → Desktop atau nxdom desktop.

Modul wajib: Buckets, Firebase, Route, ServiceWorker, dan Worker. Install memasang modul yang kurang terlebih dahulu. Alias electron, desktop, dan dekstop tetap didukung.

Reinstall mempertahankan .env dan konfigurasi. Start memerlukan Node/npm serta dependensi proyek yang sudah tersedia.

Mobile

Rute: Runtime → Mobile atau nxdom mobile.

Alur proyek baru

1. Pilih Install.
2. Isi Config untuk URL API, nama aplikasi, dan port Expo.
3. Pastikan modul wajib tersedia.
4. Pilih Start.
5. Buka Log untuk melihat QR dan status Metro.

Log dan pintasan Expo

Status proses disimpan pada .nxdom-mobile.pid dan log Metro pada .nxdom-mobile.log. Modul yang disarankan selain modul wajib: utils, Form, Storage, dan Icon.

Web Express/Node

Rute: Runtime → Web(express/node) atau nxdom web.

Modul wajib: Buckets, Firebase, Route, ServiceWorker, dan Worker. Start memerlukan Node/npm serta node_modules. Status Start dan Stop mengikuti proses server yang aktif.

Web Statik

Rute: Runtime → Web (statik) atau nxdom webstatic.

Web Statik tidak mempunyai Start/Stop. Modul wajibnya Route, ServiceWorker, Firebase, dan Buckets. Install ditolak jika proyek masih mempunyai Web Express melalui server.js; uninstall Express terlebih dahulu.

Konfigurasi Workers

webWorker.enabled
webWorker.storage
webWorker.indexedDB
serviceWorker.enabled
serviceWorker.backgroundSync

Asisten

Rute: Runtime → Asisten atau nxdom assistant.

Pilih Asisten → Setting untuk mengatur provider AI, API key, Base URL, model, streaming, konteks, dan profil. API key ditampilkan tersamarkan dan konfigurasi disimpan di folder pengguna.

Pengaturan Asisten

Provider cloud meliputi Anthropic, OpenAI, OpenRouter, DeepSeek, Groq, Gemini, xAI, Mistral, Together, Fireworks, Cerebras, Perplexity, Moonshot, DashScope, SiliconFlow, NVIDIA, dan Custom OpenAI-compatible. Provider lokal meliputi Ollama, LM Studio, vLLM, llama.cpp, dan Jan.

Konfirmasi aksi

Asisten menampilkan ringkasan dan meminta persetujuan sebelum operasi berdampak dijalankan.

Progress operasi

Asisten dapat menjalankan operasi runtime, Modules, Backend Update, migrate, generator controller, dan tes koneksi. Progress dan file aktif ditampilkan secara terpisah.

Chat dan memori proyek

• Balasan mendukung streaming dan spinner.
• Token ditampilkan sebagai input, output, total, dan total sesi.
• /clear atau /reset menghapus riwayat Chat.
• Esc atau input kosong keluar dari Chat; /exit keluar dari nxdom.
• Memori membaca runtime, registry modul, package, konfigurasi publik, PID, dan log.
• API key dan isi .env tidak dimasukkan ke memori.
• Permintaan Backend Update hanya menargetkan komponen yang disebut pengguna.
• Riwayat Chat digambar ulang setelah operasi yang membersihkan layar.

Konfigurasi global Windows disimpan di %APPDATA%\nxdom\assistant.json.

Perintah cepat

nxdom
nxdom backend
nxdom desktop
nxdom mobile
nxdom web
nxdom webstatic
nxdom modules
nxdom assistant
nxdom info
nxdom help

Shell interaktif

Baris ❯ tersedia pada menu Runtime. Tekan Tab untuk fokus dan awali perintah dengan /. Teks tanpa awalan slash dikirim sebagai percakapan ke Asisten.

/help
/info
/backend
/modules
/mobile
/desktop
/web
/webstatic
/assistant
/exit

Masalah umum

Perintah nxdom tidak dikenali

Pastikan Node.js dan npm tersedia, lokasi global npm berada di PATH, kemudian pasang ulang paket. Tutup dan buka kembali terminal setelah instalasi.

Port sudah dipakai

Pilih Stop pada runtime yang sedang berjalan, lalu Start kembali. Untuk Mobile, nxdom mencoba menghentikan proses Expo lama. Jika masih gagal, hentikan proses npm/Expo lain yang memakai port tersebut.

Log, Open Web, atau Open Android tidak berfungsi

• Jalankan Expo melalui Mobile → Start, bukan terminal terpisah.
• Jangan tutup sesi nxdom sebelum membuka Log.
• Pilih Refresh setelah menjalankan Open Web atau Open Android.
• Jika browser tidak terbuka, buka URL Metro sesuai port Config secara manual.

Modul belum terpasang atau aplikasi error

Buka menu Module pada runtime terkait dan pasang modul yang hilang. Gunakan Reinstall runtime jika struktur runtime rusak, tetapi periksa dan cadangkan perubahan proyek sebelum penggantian penuh.

GitHub membatasi permintaan

Tunggu hingga batas API direset lalu ulangi operasi. Token GitHub bersifat opsional untuk sumber publik. Jangan pernah menampilkan atau menyimpan token di repository proyek.

Memperbarui nxdom

npm update --global nxdom-cli

Jika nxdom tidak dikenali, pastikan lokasi global npm tersedia di PATH, lalu pasang ulang paket:

npm install --global nxdom-cli

Referensi

• Dokumentasi resmi NxDOM
• nxdom-cli di npm
• Repository framework