PHP FLAT FILE
CATALOGUE № 01 / CONTENT SYSTEMS

Keep your content
close to the metal.

Lightweight flat-file tools for PHP. No database to babysit. Just folders, front matter, Markdown, and output you can explain.

Pull open the cabinet
DRAWER 01

Open a real file.

Choose a card. See exactly what goes in—and what comes out.

field-notes.md
content/notes/field-notes.md
---
title: "A dependable place for small ideas"
date: 2026-08-11
tags: [notes, workflow]
---

A dependable place for small ideas

A flat-file system should feel obvious when you return six months later. Keep the content readable, the folders meaningful, and the machinery small.

GENERATES/notes/field-notes/index.html200 OK
INDEX CARDS

Small by design.

01

Readable forever

Your content remains useful with nothing more exotic than a text editor.

cat content/*.md
02

Version everything

Review a sentence the same way you review code: line by line, in Git.

git diff content/
03

Move without drama

Copy the folder. That is the export, backup, migration, and escape hatch.

cp -R ./content ./safe
PHP
8.2+
THE WHOLE RECIPE

Read. Parse. Sort. Render.

  1. 01Walk the folders
  2. 02Read front matter
  3. 03Build an index
  4. 04Render the page