Skip to main content
Panduan singkat untuk developer baru. Setup cepat: Quickstart.

​
Prasyarat

  • Bun 1.3+
  • Postgres lokal atau Neon dev
  • File .env di root (salin dari .env.example)
./thub setup
./thub dev

​
Struktur kerja

PerintahFungsi
./thub devWeb + API + renderer
./thub doctorCek env & struktur
./thub doctor --ciVersi CI (tanpa secret nyata)
bun run lint:ciLint tooling/scripts
cd apps/web && bun run testVitest frontend
cd apps/api && bun run testVitest API

​
Branch & commit

  • Branch dari main: feat/..., fix/..., docs/...
  • Commit message: conventional commits (feat:, fix:, docs:)
  • PR ke main — CI harus hijau

​
CI yang harus lulus

JobPerintah lokal
Lintbun run lint:ci
Doctor./thub doctor --ci
Docscd apps/docs && bun run validate
Web testscd apps/web && bun run test
API testscd apps/api && bun run test
Detail: CI/CD

​
Setelah ubah frontend

Wajib browser check — lihat Playwright.

​
Setelah ubah docs

cd apps/docs
bun run validate
bun run broken-links
Tambahkan halaman baru ke docs.json navigation.

​
Env & secrets

  • Shared: .env (gitignored)
  • Override dev: .env.development.local
  • Override prod: .env.production.local
  • Merge: ./thub env merge
Jangan commit secret. Deploy secrets: Secrets.

​
Deploy

  • Production: manual via GitHub Actions Deploy Cloudflare atau ./thub deploy lokal
  • Bukan auto-deploy on merge

​
Di mana cari konteks

TopikLokasi
Arsitektur produk/architecture/*
AI & prompt/ai/*
Layanan eksternal/external/*
Admin operasionalAdmin playbook
Istilah domainGlossarium

​
Repo

github.com/trisnalesmana/aimentor