Lewati ke konten

Referensi CLI

Buat kerangka proyek Bosia baru.

Terminal window
bosia create <name> [--template <template>]
OpsiDeskripsi
<name>Nama direktori proyek
--templateLewati 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.

Jalankan server pengembangan dengan hot reload.

Terminal window
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.

Build proyek untuk produksi.

Terminal window
bosia build

Perintah ini menjalankan:

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

Output disimpan ke dist/.

Jalankan server produksi.

Terminal window
bosia start

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

Instal komponen UI dari registry.

Terminal window
bosia add <component>
  • Mengunduh file komponen ke src/lib/components/ui/<component>/
  • 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:

Terminal window
bosia add button
bosia add card
bosia add input

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

Terminal window
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:

Terminal window
bosia feat login