Rule 01
A file is a record.
.json files hold structure. .md, .pdf, .png are opaque payloads. Metadata goes in a same-named .json sidecar.
The folder IS the website.
A folder format for structured content. Three rules. Any conforming reader turns the folder into a site.
The spec
Three rules. Nothing more.
Rule 02
A folder is a collection.
Any directory is a collection. Folders nest freely. index.json inside a folder is that folder's record.
Rule 03
The filename is the contract.
Names follow name[.modifier]*.ext. File form and folder form are the same identity — no rename, no broken refs.
Latest