Langsung ke konten
Tulisan

ID (bahasa aktif)EN

Astro dan Void di Cloudflare Workers: cara situs ini dibangun

Risqi Romadhoni

Situs ini memakai Astro 7 dan dikonfigurasi untuk Cloudflare Workers lewat Void. Void adalah alat untuk membangun dan men-deploy aplikasi full-stack dengan Vite. Tulisan ini mencatat susunan itu bagian demi bagian. Setiap bagian menyebut berkas yang mengaturnya.

Mode server dan halaman statis

Saya memakai output: "server" karena deploy Void membutuhkan entry Worker dari Astro. Dalam mode ini, Astro merender setiap halaman saat diminta (buka di tab baru), kecuali halaman itu memakai prerender = true.

Semua berkas di src/pages memakai prerender = true, kecuali endpoint redirect untuk URL lama. Saat build, Astro menulis hasil semua berkas itu sebagai berkas statis.

Endpoint redirect untuk URL lama tidak memakai prerender. Astro menjalankannya setiap kali alamat itu diminta.

Konfigurasi Astro

Pengaturan utama ada di astro.config.mjs. Bagian font dan integrasi tidak saya tampilkan:

astro.config.mjs
export default defineConfig({
  site,
  output: "server",
  trailingSlash: "never",
  build: { format: "file" },
  redirects: oldSiteRedirects,
  adapter: cloudflare({ configPath: "./.void-wrangler.jsonc" }),
  i18n: {
    defaultLocale: "id",
    locales: ["id", "en"],
    routing: { prefixDefaultLocale: false },
  },
  // ...
  markdown: {
    processor: satteri(satteriOptions),
    syntaxHighlight: false,
  },
  vite: { plugins: [voidPlugin()] },
});

defaultLocale diisi id, jadi URL bahasa Indonesia tidak memakai awalan. Bahasa Inggris memakai awalan /en. Nilai site diambil dari VITE_APP_SITE saat build. Nilai bawaannya ada di env.ts.

Void dan Cloudflare Workers

Plugin Void masuk ke Vite lewat voidPlugin(). void.config.ts mengatur Cloudflare, termasuk nama Worker, tanggal kompatibilitas, dan flag nodejs_als. Flag itu mengaktifkan AsyncLocalStorage. Dokumentasi Void memintanya untuk helper void/*. Kode di src/ tidak memakai void/db, void/kv, atau void/storage.

Dokumentasi Void juga meminta Astro 7, karena Void membutuhkan Vite 8. Perintah deploy pnpm void:deploy menjalankan void deploy --platform cloudflare. Void membuat .void-wrangler.jsonc, dan berkas itu tidak masuk git.

Gaya dengan UnoCSS

UnoCSS memakai presetWind4 dengan reset bawaannya, jadi tidak perlu paket reset tambahan. uno.config.ts mengubah token warna dari DESIGN.md menjadi variabel --lr-*. Kelas seperti text-lr-nav memakai variabel itu. Kelas dark di elemen html mengaktifkan mode gelap.

UnoCSS juga memindai Markdown di src/. Kelas yang dipakai di dalam tulisan ikut dibuat.

Tulisan sebagai Markdown

Setiap tulisan berupa berkas Markdown di src/content/posts/id/. Versi Inggrisnya, kalau ada, memakai slug yang sama di src/content/posts/en/. Skemanya ada di src/content.config.ts. Empat field ini wajib diisi: title, summary, date, dan topic. Nilai topic harus ada di src/shared/api/content/topics.ts.

Astro memproses Markdown lewat @astrojs/markdown-satteri, dengan fitur direktif. Direktif :::nama membuka blok seperti diagram dan checklist. Nama yang tidak ada dalam daftar di src/app/markdown/directives.ts melempar error saat Markdown diproses.

Dua bahasa dan salinan Markdown

Bahasa Indonesia adalah bahasa bawaan. Versi Inggris ada di /en/writing/. Fungsi pembuat URL untuk tiap bahasa ada di src/shared/i18n/routes.ts.

Setiap tulisan juga punya salinan Markdown mentah, misalnya /tulisan/situs-ini-astro-void-cloudflare-workers.md. Berkas /llms.txt mendaftar semua salinan itu dalam format llmstxt.org.

URL lama heyris.me

Konfigurasi situs ini mengalihkan alamat lama heyris.me ke alamat baru dengan status 301. Endpoint di src/pages mengalihkan alamat tulisan /posts/<slug> ke /en/writing/<slug>, dan /id/posts/<slug> ke /tulisan/<slug>. Opsi redirects di astro.config.mjs mengatur alamat halaman lain, seperti /about.

Tes dan target Lighthouse

Vitest berjalan lewat vp test, dengan tiga proyek di vite.config.ts:

  • unit: berkas *.test.ts, berjalan di Node.
  • browser: berkas *.browser.test.ts, berjalan di Chromium headless.
  • types: berkas *.test-d.ts, hanya memeriksa tipe lewat tsc.

Tes end-to-end memakai Playwright di folder e2e/. Pemindaian aksesibilitas memakai axe dan hanya mencakup tag WCAG 2.0, 2.1, dan 2.2 di tingkat A dan AA (e2e/fixtures.ts). Target situs adalah WCAG 2.2 tingkat AA.

Job Unlighthouse membangun situs, menyalakan astro preview, lalu memeriksa halaman dengan budget dari unlighthouse.config.ts. Budget berisi skor minimum per kategori. Job CI gagal kalau skor di bawah angka itu.

Berikut angkanya:

  • Performa: skor minimum 90
  • Aksesibilitas: skor minimum 100
  • Praktik terbaik: skor minimum 100
  • SEO: skor minimum 90

CI dan riwayat commit

.github/workflows berisi enam alur: check, test, playwright, unlighthouse, size, dan release. Alur check berjalan di setiap push dan pull request ke main. Empat alur berikutnya hanya berjalan kalau berkas yang memengaruhinya berubah. Alur release membuat pull request rilis dan men-deploy ke Cloudflare. Alur unlighthouse juga bisa dijalankan manual lewat workflow_dispatch. Kalau input site diisi, job memindai situs yang sudah di-deploy, bukan hasil build lokal.

Riwayat commit dimulai 12 November 2026. Beberapa commit berikut, dari yang terbaru, menandai tahap pembangunannya:

  • test: set up Vitest with unit, browser and type projects49fd2cc
  • feat(i18n): add the english routes77ec300
  • feat(markdown): render the design’s content blocks from directives5cb34c9
  • feat(ui): set up unocss with wind4, typography and design tokensed245d0
  • ci: add check, playwright and unlighthouse workflowsc4ea45a
  • feat(deploy): integrate void with cloudflare adapter35e91de

Ada yang keliru? Kabari saya