Welcome to Nostalgia PHP

A caveman-simple file-based CMS

Rock, Paper, Markdown

Build real content sites fast with flat files. Markdown in, HTML out. No framework. No database. Just pages, collections, and a few partials.

NostalgiaPHP project structure overview
Example project structure

The Simple Superpowers

Files, no faff

Pages and collections are just .md files with front-matter. Rename a file to change a URL. That’s it.

Templates & partials

Choose your template. Wrap your content; partials handle header, footer, hero, etc.

Portable content

Your “CMS” is Markdown. Move it anywhere—PHP today, something else tomorrow—no export dance.

Zero build step

No Node, no bundlers. Drop on a PHP host or run php -S localhost:8000 and you’re live.

Instant sitemap

sitemap.xml is built automatically from your content—no plugins needed.

404, sorted

Bad links happen. A built-in 404.php route is ready out of the box—or tweak it to fit your site.

How it works

  1. Write content in content/pages and content/collections/{name}.
  2. Add front-matter for title, description, date (optional).
  3. Pick a template via template: main (or your own), and ship.
View the Dox
NostalgiaPHP project structure overview
Example project structure

From the blog

Browse the latest posts and examples.

See all posts →