When I first built my website on Astro, I loved how fast it was. Writing posts in Markdown was easy for me, but the moment anyone else needed to edit content the whole thing got complicated. I had to explain Git, GitHub, commits, pull requests, Markdown formatting and image uploads before a single paragraph could change, which is a lot of teaching for a job that should take a minute. That is when I found Pages CMS, and it solved a problem I had not noticed I had.
What is Pages CMS?
Pages CMS is a free and open-source content management system that works directly with your GitHub repository. Instead of storing your content in a separate database, it edits the files that already sit in your project.
If your website runs on Astro, Hugo, Jekyll, Next.js, Nuxt, VuePress or 11ty, it works with Pages CMS.
No Database, No Backend
This is the part that makes Pages CMS unusual. Most traditional CMS platforms need a database, authentication, APIs and a separate place to host the CMS itself. Pages CMS needs none of that, because your content already lives inside your GitHub repository and the CMS is only an interface for editing those files.
How It Works
Need a website built properly?
Fast, modern, fully owned — from ₹7,999, delivered in 1–2 weeks.
Chat on WhatsAppSee pricingThe setup is short.
- Create your Astro website.
- Add a
.pages.ymlconfiguration file. - Sign in to Pages CMS with GitHub.
- Connect your repository.
- Start editing content through the visual interface.
Whenever you save a change, Pages CMS commits it straight to your GitHub repository. No copying files, no FTP, no manual uploads.
Why I Like It
There are plenty of CMS options available, but this one does a single job well.
Simple Setup
Unlike many CMS platforms there is no long installation process. Once your configuration is ready, you can start writing.
Perfect for Astro
Astro stores blog posts as Markdown files, so Pages CMS fits the way the site already works. It lets you create posts, edit Markdown, upload images, manage frontmatter and search content without touching Git.
Your Content Stays Yours
The thing I like most is that your content always stays inside your GitHub repository. There is no second platform holding your articles and no extra database to maintain, so everything remains where it belongs and your Git history keeps working exactly as before.
Great for Clients
Imagine building a website for a client. Normally you would have to teach them GitHub, Markdown and the repository structure before they could touch a post. With Pages CMS they log in and edit through a clean interface, which is a better experience for both of you.
Media Management
Uploading images is the easy part. Instead of copying files into folders by hand, you upload and organise assets in the media manager, and they land inside your repository.
Why I Chose It Over Other CMS Options
I looked at several headless CMS platforms and most of them are good products. For a static Astro site, though, many felt like overkill: I did not want a separate database, API tokens, a monthly subscription or complex user management. I wanted an easy way to edit Markdown files, which is exactly what Pages CMS does.
Is It Free?
Pages CMS is free and open source under the MIT License. You can use the hosted version, deploy your own instance, or contribute to the project yourself.
Who Should Use Pages CMS?
I would recommend it if you are building an Astro blog, a personal site, documentation, a company website, a portfolio or a static landing page. If your content already lives in GitHub, Pages CMS fits.
Huge Respect to the Creator
One thing I always appreciate about open-source software is the people behind it. Pages CMS was built by Ronan Berder, known online as @hunvreus, who wanted editing Git-based static sites to be simple without adding unnecessary complexity.
If Pages CMS helps you or your team, you can support the project by starring the GitHub repository, reporting bugs, contributing code or sponsoring the creator.
GitHub Profile: https://github.com/hunvreus
Project Repository: https://github.com/pages-cms/pages-cms
Official Website: https://pagescms.org
Open-source projects grow because of the people who show up for them, and Pages CMS is a good example of that.
What It Does Not Try To Be
Pages CMS does not replace WordPress and does not compete with enterprise CMS platforms. It solves one narrow problem, which is making Git-based websites easy to edit. If you already run Astro, Hugo, Next.js or another static site generator, it slots into the workflow you have, and for me it has become a normal part of publishing.
Tags
#pages-cms #astro#github#cms#markdown