Referensi CLI - Bosia Docs

bosia create

Buat kerangka proyek Bosia baru.

bosia create <name> [--template <template>]

Opsi	Deskripsi
`<name>`	Nama direktori proyek
`--template`	Lewati pemilih template: `default` atau `demo`

Template:

default — Starter minimal dengan halaman utama, halaman about, dan satu server loader
demo — Contoh lengkap dengan blog, rute API, form actions, hooks, dan catch-all routes

Setelah kerangka dibuat, bun install akan berjalan secara otomatis.

bosia dev

Jalankan server pengembangan dengan hot reload.

bosia dev

Server dev berjalan di http://localhost:9000
Perubahan file memicu reload browser otomatis melalui SSE
Menggunakan arsitektur proxy: dev proxy di :9000, server aplikasi di :9001
Auto-restart saat crash — jika proses aplikasi keluar secara tak terduga, server akan restart otomatis. Setelah 3 crash cepat dalam 5 detik, server berhenti mencoba ulang dan menunggu perubahan file.

bosia build

Build proyek untuk produksi.

bosia build

Perintah ini menjalankan:

Pemindaian rute dan pembuatan manifest
Pembuatan tipe ($types.d.ts files)
Pembuatan modul variabel lingkungan ($env)
Bundle klien (JavaScript + CSS via Tailwind)
Bundle entry server
Prerendering statis (rute dengan export const prerender = true)

Output disimpan ke dist/.

bosia start

Jalankan server produksi.

bosia start

Menjalankan server yang sudah di-build dari dist/. Membutuhkan bosia build yang sudah dijalankan terlebih dahulu.

bosia test

Jalankan tes dengan bun test, terintegrasi framework.

bosia test [args]

Memuat otomatis .env, .env.local, .env.test, .env.test.local (file berikutnya menimpa sebelumnya; env sistem menang)
Menetapkan BOSIA_ENV=test dan NODE_ENV=test (hanya jika belum diset)
Meneruskan NODE_PATH agar dependensi framework bisa diresolusi saat tes
Meneruskan semua flag ke bun test (--watch, --coverage, --bail, --timeout, filter file/direktori)
Meneruskan exit code dari Bun

Contoh:

bosia test
bosia test --watch
bosia test --coverage
bosia test src/lib/foo.test.ts

Letakkan file tes di mana saja yang ditemukan Bun (default: *.test.ts / *.test.tsx / *.spec.ts / file di __tests__/).

bosia add

Instal komponen UI dari registry.

bun x bosia@latest add <component>

Mengunduh file komponen ke src/lib/components/ui/<component>/
Mendukung nama berbasis path — bun x bosia@latest add shop/cart menginstal ke src/lib/components/shop/cart/
Komponen tanpa prefix path default ke ui/ — bun x bosia@latest add button → src/lib/components/ui/button/
Jika komponen sudah ada, akan bertanya apakah ingin mengganti atau lewati
Secara otomatis menginstal dependensi komponen (komponen lain yang menjadi dependensinya)
Menginstal paket npm yang diperlukan melalui bun add
Registry dihosting di GitHub: bosapi/bosia/main/registry/components/

Contoh:

bun x bosia@latest add button              # → src/lib/components/ui/button/
bun x bosia@latest add card                # → src/lib/components/ui/card/
bun x bosia@latest add shop/cart           # → src/lib/components/shop/cart/

bosia feat

Buat kerangka fitur (routes + components + server files).

bosia feat <feature>

Menginstal komponen UI yang diperlukan terlebih dahulu melalui bosia add
Menyalin file fitur ke lokasi yang sesuai dalam proyek Anda
Menginstal paket npm yang diperlukan
Registry dihosting di GitHub: bosapi/bosia/main/registry/features/

Contoh:

bosia feat login