Deployment
Perencanaan URL production, matriks env, dan kapan mengadopsi deployment berbasis subdomain.
Kit ini berjalan sebagai dua permukaan Next.js:
apps/marketingapps/docs
Secara lokal, semuanya memakai port yang berbeda. Di production, pertahankan URL publik masing-masing lewat env vars yang eksplisit.
Matriks URL production
| Surface | Env var | Contoh |
|---|---|---|
| Marketing (landing, API, checkout) | NEXT_PUBLIC_MARKETING_URL | https://www.example.com |
| CORS / origin paket sisa | NEXT_PUBLIC_APP_URL / NEXT_PUBLIC_SAAS_URL | Sama dengan marketing |
| Situs docs | NEXT_PUBLIC_DOCS_URL | https://docs.example.com |
Pengingat Better Auth
Auth ada di @repo/auth. Repo ini tidak memuat rute auth dasbor. Jika Anda memakai ulang paket itu, setel BETTER_AUTH_URL ke origin yang memasang /api/auth. Jangan tambahkan origin docs sebagai trusted origin kecuali Anda memang membutuhkan auth flow di sana.
Gate deployment subdomain
Hanya tambahkan rewrite subdomain atau setup dua proyek Vercel jika Anda siap mengoperasikan www. dan docs. secara terpisah.
Payments dan webhook
Webhook Mayar storefront harus menunjuk ke origin marketing:
{MARKETING_URL}/api/webhooks/mayar
Adapter kit sisa masih mendokumentasikan path webhook Polar / Midtrans / DOKU; path itu tidak di-host di sini kecuali Anda memasangnya kembali. Panduan lengkap: Pembayaran dan Checkout storefront.