Getting Started with AstroCMS
Everything you need to know to set up your first content-driven site with Astro 6 and Cloudflare Workers.
What is AstroCMS?
AstroCMS is a modern content platform built on Astro 6 and deployed to Cloudflare Workers. It combines Astro's zero-JavaScript-by-default philosophy with Cloudflare's global edge network to deliver content faster than anything else out there.
Whether you're building a personal blog, a documentation site, or a full editorial platform, AstroCMS gives you the tools to ship fast without sacrificing developer experience.
Prerequisites
- Node.js 22.12 or later
- A Cloudflare account (free tier works)
- Familiarity with HTML, CSS, and Markdown
Project Structure
After scaffolding, your project will look like this:
src/
├── components/ # Reusable Astro components
├── layouts/ # Page layouts (nav, footer)
├── pages/ # File-based routing
│ ├── index.astro
│ ├── about.astro
│ └── blog/
│ ├── index.astro
│ └── getting-started.astro
└── assets/ # Images, SVGs
Every .astro file in src/pages/ becomes a route. No configuration needed.
Astro's file-based routing makes it trivially easy to add new pages.
Adding Content
The fastest way to add a new page is to create a new .astro file in src/pages/.
For blog-style content, you can use Markdown files with frontmatter, or leverage Astro's
Content Collections for type-safe content with schemas.
Deploying
With the Cloudflare adapter already configured, deploying is a single command:
npx astro build && npx wrangler deploy Your site will be live on Cloudflare's edge network within seconds, served from 300+ locations worldwide. That's the power of AstroCMS.
Next Steps
From here, the world is yours. Add content collections, integrate a headless CMS, bring in React or Vue components as islands, or keep it pure Astro. The platform adapts to your workflow, not the other way around.