Build & Deploy

Setelah dokumentasi Anda siap, Anda perlu mem-build-nya menjadi file statis agar dapat dipublikasikan.

Membangun Situs (Build)

Jalankan perintah berikut untuk menghasilkan versi produksi dari situs Anda:

npm run docs:build

Hasil build akan disimpan di folder .vitepress/dist. Folder ini berisi file HTML, CSS, dan JS statis yang siap di-hosting.

Deployment

VitePress dapat di-host di hampir semua layanan hosting statis.

GitHub Pages

1. Pastikan kode Anda ada di repositori GitHub.
2. Gunakan GitHub Actions untuk mem-build dan men-deploy secara otomatis.
3. Anda bisa menggunakan template workflow resmi dari VitePress.

Vercel / Netlify

1. Hubungkan repositori Anda ke dashboard Vercel atau Netlify.
2. Atur Build Command: npm run docs:build.
3. Atur Output Directory: .vitepress/dist.
4. Klik Deploy!

Cloudflare Pages

Untuk men-deploy VitePress ke Cloudflare Pages, gunakan pengaturan berikut di dashboard Cloudflare:

1. Framework Preset: None atau Other.
2. Build command: npm run docs:build.
3. Build output directory: .vitepress/dist.
4. Root directory: / (Tetap biarkan default).

PENTING: Versi Node.js VitePress membutuhkan Node.js v18+. Di dashboard Cloudflare Pages, tambahkan Environment Variable berikut:

• Variable name: NODE_VERSION
• Variable value: 18 (atau lebih tinggi).

Jika Anda menggunakan CLI (Wrangler), perintahnya adalah:

npx wrangler pages deploy .vitepress/dist

Preview Lokal

Setelah melakukan build, Anda dapat mencoba melihat hasilnya secara lokal:

npm run docs:preview