reboot-cms AGENTS.md

AGENTS.md

Guidance for AI coding agents working in a Reboot CMS project.

This file is a condensed orientation. For the full reference — installation, configuration, addons, blocks and multilingual navigation — read the project's README.md in full before making non-trivial changes.

What this is

Reboot CMS is a flat-file, database-free CMS in PHP. Content is plain Markdown, pages render through optional blocks, and every URL maps directly to a file. There is no database, no schema, and no build step for content.

Project layout

• core/src/Shaack/ — CMS core classes (Reboot, Site, Page, Block, Request, AddOn)
• core/admin/ — admin interface (itself a Reboot CMS site)
• site/ — the site you edit:
  • pages/ — content pages (.md or .php)
  • blocks/ — PHP templates for content blocks
  • addons/ — site-specific addon classes
  • template.php — main HTML template
  • config.yml — navigation, addon registration, multilingual settings
• web/ — document root (index.php, static assets)
• local/ — environment config (config.yml, .htpasswd) — not in Git
• tests/ — test suite

Routing: file = URL

A request path maps straight onto site/pages/:

• / → pages/index.md
• /about → pages/about.md
• /howto/git → pages/howto/git.md
• a folder is served by its index.md

To find a page's source, append the URL path to site/pages/. To add a page, create the file — no route registration needed. A .php page is used when no .md exists at that path.

Pages

A page is Markdown. Optional YAML frontmatter at the top sets metadata:

---
title: About
hide-nav: true
---

A page is split into blocks with HTML comments. Without any block comment the whole file renders as a single text block:

<!-- hero -->
# Welcome

<!-- text -->
Some content.

Blocks

Each block name maps to site/blocks/{name}.php. A block template is plain PHP and receives a $block object — $block->content(), $block->xpath(), $block->getConfig(). Adding a block type means adding one PHP file; there is no framework or build step in between.