Quick Start
QuickstartGet the project running locally in minutes.
Prerequisites
Section titled “Prerequisites”- Node.js 26 LTS (the repo pins it in
.node-version; fnm and nvm pick it up) - pnpm 12 (
corepack enable— the version comes frompackageManagerinpackage.json) - Cloudflare Account (free tier works)
Clone & Install
Section titled “Clone & Install”git clone https://github.com/milzamsz/astro-cloudflare-starter.gitcd astro-cloudflare-starterpnpm installEnvironment Setup
Section titled “Environment Setup”cp .env.example .envMost variables are optional for a static site. Set SITE_URL for correct
canonical/OG/sitemap URLs in production.
Run Development Server
Section titled “Run Development Server”pnpm devVisit http://localhost:4321 — English is served at the root (/). The i18n
engine is ready for additional locales when you need them.
Build for Production
Section titled “Build for Production”pnpm buildThe output is in dist/ — ready for Cloudflare Pages deployment.
Check your work
Section titled “Check your work”pnpm lint # oxlint, eslint (.astro), stylelint, type-check (TS 7 + astro check), design KPIspnpm test # unit tests (Vitest)pnpm test:e2e # end-to-end + CSP tests (Playwright, runs against the built site)pnpm lighthouse # Lighthouse budgets against dist/Was this helpful?