Lightweight Flat-File CMS Options for Static HTML Websites (No Database Required)
If you're building a small website — a brochure site, a business one-pager, a portfolio, a blog with a handful of posts — a full CMS like WordPress is overkill. You probably don't need a database, a 200-megabyte install, or a permanent stream of security updates. You need something lightweight that lets you (or your client) edit the content without touching code.
That's what a flat-file CMS is for. This post is an honest comparison of the main options, with a short answer to the question "which one should I pick?" at the end.
What is a flat-file CMS?
A flat-file CMS stores content directly in files on disk — usually HTML, Markdown, YAML, or JSON — instead of in a relational database like MySQL or PostgreSQL. There is no database to install, back up, or secure. The content lives next to the code in the website folder, and you can copy the whole site to another server by moving files.
Most flat-file systems are written in PHP and run on any cheap shared host. A few are written in Go, Node, or Python.
Why choose a CMS without a database?
- Lower attack surface. No SQL injection risk. No database credentials to leak.
- Cheap hosting. Any PHP host works. Nothing to configure.
- Simple backups. Zip the folder. That's the backup.
- Easy migration. Copy the folder to a new server. Done.
- Git-friendly. Version your content the same way you version your code.
- Faster page loads. No query overhead on each request.
The tradeoff: flat-file systems usually don't scale well past a few hundred pages, and they're not the right tool if you need complex content modelling, multi-user workflows, or relational queries across thousands of records. For a small business site, none of that matters.
7 lightweight flat-file CMS options compared
Grav
The most popular flat-file CMS. Markdown-based. Strong plugin ecosystem, good admin panel, Twig templating. Steeper learning curve than most. Good for developers who want flexibility. PHP, free, open source.
Best for: developers building custom sites from scratch.
Kirby
Commercial (€99 per site). File-based content with a clean block-based admin panel. Highly extensible via PHP. Beautifully documented. Designers who hand-code HTML often pick Kirby because it doesn't impose a theme system on you.
Best for: designers and agencies building bespoke sites for clients.
Pico
Minimal Markdown-only CMS. Less than a megabyte. No admin panel by default — you edit .md files directly, or add a plugin for browser editing. Twig templates. Great for technical users who want the simplest possible setup.
Best for: developers who are comfortable editing Markdown files in a text editor.
SiteCake
HTML-first instead of Markdown-first. You start with an existing static HTML website, mark editable regions with a single CSS class (sc-content), and SiteCake gives you an inline drag-and-drop WYSIWYG editor on top of your real pages. No separate admin screen — you edit the page as it looks. No database, no Markdown learning curve.
Content saves directly back to your HTML files. Images go into a images/ folder on disk. Publishing creates a timestamped backup automatically.
Requires PHP 7.4+ and ~2 MB disk space. Free demo. $99 regular license or $199 white-label (for agencies who want to rebrand it for clients).
Best for: agencies and small businesses where the person editing the site is not technical and doesn't want to learn Markdown or a dashboard.
HTMLy
Blog-focused, Markdown-based, open source PHP. Clean default theme, reasonably fast. Feature set narrower than Grav but enough for most personal blogs. Good SEO defaults.
Best for: personal or team blogs where Markdown is fine.
Statamic
Commercial ($259 one-time). Built on Laravel. Flat-file by default, but optionally backs with a database for larger sites. Enterprise-feeling admin panel. Powerful content modelling with "collections" and "blueprints." Probably overkill for small brochure sites.
Best for: mid-size sites where you want Laravel underneath and flat-file on top.
GetSimple
XML-based rather than Markdown. Mature but the project has slowed in recent years. Dead-simple admin panel. Works on almost any shared host. Worth a look if you want something from the "old reliable" category.
Best for: tiny sites where you want a mature tool and don't mind slower development cadence.
How to choose the right flat-file CMS
Pick based on three questions:
- Does the person editing know Markdown? If yes, Grav / Kirby / Pico / HTMLy are all fair choices. If no (and this is most small-business clients), you want something with inline or block-based WYSIWYG editing — Kirby, SiteCake, or Statamic.
- Do you already have static HTML? If you've hand-coded a site or bought a template, the fastest path is a CMS that drops onto your existing HTML — SiteCake is the most direct. Otherwise you're rebuilding the site in a theme system.
- How many pages? Under 50 — any of these work. 50 to a few hundred — Grav, Kirby, Statamic scale better. Above that, consider whether flat-file is still the right choice.
Recommended by use case
- Agency building brochure sites for non-technical clients: SiteCake (inline editing) or Kirby (block editor)
- Developer hobby site or personal blog: Grav or Pico
- Blog with regular posts in Markdown: HTMLy
- Mid-size site with custom content models: Statamic
- Just a landing page with occasional text edits: SiteCake — fastest setup for existing HTML
About SiteCake specifically
Since this is the SiteCake blog, a short honest note on where we fit.
SiteCake is opinionated. It's built for one scenario: a designer or agency has made a static HTML website for a small business, and wants the owner to be able to edit text and swap images without breaking anything. Not Markdown. Not a dashboard. Not plugins. Just click on the page, change the text, hit publish.
If that's the scenario, SiteCake is probably the fastest path. If you want templates, plugins, content modelling, or Markdown-based workflow, one of the others above will suit you better.
You can try SiteCake on your own HTML in about 5 minutes: installation guide or live demo. Licensing is on the download page — free trial, then $99 regular or $199 white-label for agencies.