---
name: Blatt project
description: Custom flat-file markdown publishing server replacing WriteFreely on Unraid. Spec and plan in docs/superpowers/.
type: project
---

Blatt is a zero-config, single-person markdown publishing server built with Bun + Hono + remark/rehype + Nunjucks.

**Why:** WriteFreely had poor UX, Grav had premium upsells. Blatt is the "anti-CMS" — drop markdown files in a folder, they're served as HTML with templates.

**How to apply:** The project lives at `~/Developer/blatt/` (new repo). The `felixfoertsch.de` repo holds the content and spec/plan docs. Content will be served from an Unraid Docker container (port 8087, replacing the old Grav/WriteFreely containers).

**Key decisions:**
- Runtime: Bun (dev + Docker)
- Content model: folder-per-page with co-located assets, ISO 8601 date prefixes
- Templates: Nunjucks with inheritance, per-page selection via frontmatter
- Drafts: `published: false` in frontmatter, visible on trusted network or with token
- Config: single `config.toml`, everything on by default
- WriteFreely content needs importing into the new format