Files
felixfoertsch.de/.claude/memory/project_blatt.md

1.1 KiB

name, description, type
name description type
Blatt project Custom flat-file markdown publishing server replacing WriteFreely on Unraid. Spec and plan in docs/superpowers/. 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