create-nuxion

create-nuxion

Scaffold Nuxion — starter kit monorepo NestJS + Nuxt/Next — menjadi project baru dalam satu perintah:

bun create nuxion@latest nama-project

Kit punya dua variant frontend: Nuxt 4 (default) dan Next.js 16. Pilih Next dengan flag (atau jawab prompt interaktif):

bun create nuxion@latest nama-project --frontend next

Prasyarat

• Bun ≥ 1.3
• git

Flags

--frontend next butuh template kit yang sudah membawa apps/web-next (nuxion PR #46 ke atas). Flag hanya diteruskan ke init saat dipilih eksplisit, jadi --branch <ref-lama> tetap aman.

Yang dilakukan

1. Clone shallow dari GitHub → nama-project/
2. Buang .git lalu git init baru tanpa remote — tidak ada cara salah push ke repo Nuxion, dan riwayat commit kit tidak terbawa
3. Jalankan scripts/init-project.ts milik kit: rename @nuxion/*, slug, dan display name, pilih variant frontend (variant satunya dihapus; pilihan next memindahkan apps/web-next menjadi apps/web di port 8080), lalu tulis .env dari .env.example (JWT_SECRET digenerate)
4. Hapus meta-dok kit: .agents/, .zcode/, AGENTS.md, docs/, LESSON.md, MEMORY.md, ERRORS.md, scripts/init-project.* beserta entry "init" di package.json (SPEC.md, .github/, dan docker/ tetap dipertahankan)
5. bun install + commit pertama (chore: scaffold dari create-nuxion)

Template diambil langsung dari branch main repo Nuxion saat perintah dijalankan — tidak di-bundle ke paket ini, jadi scaffold selalu memakai template terbaru dan paket ini hanya perlu di-publish ulang bila CLI-nya berubah.

Test

npm test   # node --test bin/ — argument handling murni

Scaffold end-to-end diuji manual terhadap clone nyata (lihat step di atas).

Publish (maintainer)

npm login          # verifikasi dulu: npm whoami harus mengembalikan username
npm version patch  # atau minor / major
npm publish
npm view create-nuxion   # cek hasil publish