Situs publik Kamus Digital Sambas-Indonesia. Pengunjung mencari dan membaca kata sebagai tamu, tanpa login. Halaman dirender SSR di edge (HTML + meta + JSON-LD) supaya crawler melihat konten utuh sebelum hydration.
Kode dan dokumentasi di repo ini ditulis bersama agen AI. Manusia tetap yang memutuskan arah produk, meninjau setiap perubahan, dan menjalankan verifikasi sebelum rilis. Tidak ada agen yang punya akses commit, merge, atau deploy otomatis. Semua keputusan akhir ada di tangan pengelola.
| Layer | Pilihan |
|---|---|
| Framework | React 19 + React Router v7 (ssr: true) |
| UI | Mantine v9, Lucide icons |
| Bahasa | TypeScript (strict) |
| Build | Vite + @cloudflare/vite-plugin |
| Deploy | Cloudflare Workers (bukan Pages) |
Acuan tetap: docs/web/web-base-stack.md di repo
sambasku-docs.
Kontrak response mengikuti docs/api/*.
| Mode | URL | SEO |
|---|---|---|
| development | http://localhost:5173 |
off |
| staging | https://sambasku-web-staging.iamutaki.com (DNS Cloudflare) |
off (noindex) |
| production | https://sambasku.com |
on |
Nilai VITE_* di-inline saat build dari .env.development /
.env.staging / .env.production. Tidak ada secret di bundle.
VITE_GA_MEASUREMENT_ID (GA4, G-XXXXXXXX) hanya dipakai di produksi;
kosong = analytics tidak dimuat. Search Console sudah diverifikasi di luar
repo (DNS/properti); lihat docs/webmaster/VERIFIKASI-CONSOLE.md.
Dev: Vite mem-proxy /api ke API staging (same-origin, bebas CORS).
| Jenis | Sumber |
|---|---|
| Gambar kata / avatar | sambasku/images via jsDelivr; tampilan di-resize lewat wsrv (displayImageUrl) |
| Audio pelafalan | sambasku/audios via jsDelivr |
app/
├── routes/ # file-based routes (SSR)
├── presentation/ # komponen UI + utils (display-image-url, SEO)
├── application/ # use-case / formatter
├── domain/ # tipe murni
├── infrastructure/ # apiClient (fetch)
└── worker.ts # entry Cloudflare Workers + security headers
| Perintah | Fungsi |
|---|---|
pnpm install |
Pasang dependensi |
pnpm dev |
Dev server SSR di workerd (port 5173) |
pnpm typecheck |
react-router typegen + tsc -b |
pnpm lint |
ESLint (0 warning) |
pnpm build |
Build production → dist/client + dist/server |
pnpm build:staging |
Build mode staging |
Deploy murni lewat CI/CD (.github/workflows/deploy-staging.yml /
deploy-production.yml): push ke branch terkait → typecheck + lint +
build → wrangler deploy memakai config di dist/server/wrangler.json.
Custom domain Worker diikat sekali di dashboard Cloudflare
(Workers → Domains & Routes). Staging harus tetap *.iamutaki.com
supaya konsisten dengan domain API.
- Tidak ada login / sesi pengguna (itu admin + mobile)
- Tidak menulis file ke GitHub asset repo (itu API)
- Jangan deploy ke Cloudflare Pages: SSR butuh Worker
