Astro Blog Starter with Netlify CMS is a blog template that pairs the Astro static site generator with Netlify CMS, giving you a git-backed content editing interface out of the box. This starter extends the basic Astro blog starter kit with the Astro Netlify CMS integration, so you get a complete blog site plus an admin panel for publishing.
What is Astro Blog Starter with Netlify CMS?
This template is a pre-configured blog project built on Astro and Netlify CMS. It takes the standard Astro blog starter as its base and adds the Astro Netlify CMS integration, which registers an admin interface for content management. The output is a static blog site generated into a dist directory when you run pnpm run build, and the same project includes Netlify CMS configuration for editing posts from a web browser. The template was created by delucis, the author of the Astro Netlify CMS integration.
Key Features
- Netlify CMS integration — Adds the Astro Netlify CMS integration so the blog has an
/adminpath where editors can create and modify posts without touching code. - One-click Netlify deployment — The README includes a Deploy to Netlify button that copies the project to your own GitHub or GitLab account and configures continuous deployment automatically.
- Netlify Identity authentication — The setup requires activating Netlify Identity in the Netlify UI and enabling Git Gateway to allow email/password login for the CMS.
- Local CMS proxy —
pnpm run devstarts the local development server alongside a Netlify CMS proxy server, so you can preview the site and the admin interface together. - Static production build —
pnpm run buildgenerates a complete static site in./dist/, andpnpm run previewserves that build while also running the CMS proxy. - Package manager flexibility — Commands are demonstrated with pnpm, but the README explicitly says you can use npm or yarn if you update the build commands in
netlify.toml. - Based on the official Astro blog starter — Inherits the pages, Markdown-based post structure, and styles from Astro’s basic blog starter kit, so you get a standard blog layout immediately.
Who is it for?
- Developers who want a ready-made blog with a CMS and are comfortable modifying Astro configuration and Netlify settings.
- Content creators who prefer a web-based editor over writing Markdown files locally and want their posts committed to a Git repository automatically.
- Teams that need a simple publishing workflow where non-technical editors can log into Netlify CMS and publish updates to a static site.
What can you do with this template?
- Launch a CMS-backed blog: Click the Deploy to Netlify button, activate Netlify Identity, enable Git Gateway, and your live blog will have a working admin interface.
- Edit content from any browser: Use the
/adminpage on your deployed site to write, edit, and publish blog posts, with changes saved as commits in your repository. - Preview content locally: Run
pnpm run devto start both the site and the CMS proxy, letting you test content changes on your machine before deploying.
How does the template work?
The quick deploy flow copies the repository to a GitHub or GitLab account and wires up continuous deployment on Netlify. After the first deploy, you must go into the Netlify dashboard to activate Netlify Identity and enable Git Gateway, which lets people sign in with email and password. Once that’s done, content editors can log into the admin UI, and their changes are committed through Git Gateway back to the repo, triggering Netlify to rebuild the static site.
FAQ
How do I set up the template after deploying to Netlify?
After the deploy button copies the project and sets up continuous deployment, activate Netlify Identity in the Netlify UI and enable Git Gateway. Then run pnpm install and pnpm run dev locally to start developing, or open the /admin page on your deployed site to manage content.
Can I use npm or yarn instead of pnpm?
Yes. The README lists commands using pnpm, but you can switch to npm or yarn. If you do, update the build and dev command configuration in netlify.toml so Netlify runs the correct package manager commands.
Where is the production site output?
Running pnpm run build produces a static site in the ./dist/ folder. You can preview this output locally with pnpm run preview, which also starts the Netlify CMS proxy server so you can test the admin interface against the built site.
Does this template require Netlify Identity to work?
Yes. The template is designed to use Netlify Identity for authentication in Netlify CMS. You need to activate Netlify Identity and enable Git Gateway in the Netlify UI; without these steps, email/password login for the admin panel won’t function.
