Pages

File routing & assets

Every blocks/*.html file becomes a route by its path: index.html → /, <name>.html → /<name>, and nested folders nest. Blocks win over static files; anything under assets/ is served at the root as the fallback.

The backend on disk

implementation/apps/docs/
├─ blocks/
│  ├─ index.html          →  /
│  ├─ routing.html        →  /routing
│  ├─ layouts.html        →  /layouts
│  └─ layouts/
│     └─ shell.html       →  /layouts/shell
└─ assets/
   └─ images/valley.png   →  /images/valley.png

Live routes — every link really resolves

/ blocks/index.html /routing blocks/routing.html /layouts blocks/layouts.html /layouts/shell blocks/layouts/shell.html

A file under assets/

<img src="/images/valley.png" alt="served from assets/" />

assets/images/valley.png is served verbatim at /images/valley.png. A block at the same path would win over it.

Live — the same file, served