Postlet is a simple static blog publisher built around markdown files and a small plugin pipeline.
Postlet keeps blog publishing straightforward: write markdown, run one build command, and ship static files. It stays small by default, but gives you plugin hooks when you need to extend behavior.
The official Postlet homepage and author's own personal blog are built and published using Postlet.
- Markdown + frontmatter pages
- One-level page output (
/<slug>/index.html) - Extendable plugin hooks
- Optional related posts from embeddings or local keyword scoring
- Root or subpath deployment via
site.basePath - Tag pages, SEO meta, heading anchors
- Theme support plus per-page CSS overrides
- Static asset copying from
pages/todist/
npm install
npm run build
npm run servenpm run serve builds once, serves dist/ at http://localhost:8080, and rebuilds
on changes to source pages, templates, styles, themes, plugins, or core build code.
To serve an already-built dist/ without watching files, use:
npm run serve:static- Full project documentation: PROJECT.md
- Plugin system details: PLUGINS.md
This project is licensed under the MIT License - see the LICENSE file for details.
freakynit and Claude (AI assisted, not vibe-coded)