Skip to content

folderblog 0.1.0

Choose a tag to compare

View all tags
@ninepointlabs ninepointlabs released this 30 Sep 16:28
· 79 commits to main since this release
v0.1.0
d15801e

First release of folderblog: a folder is a blog. Save a Markdown file into ~/Blogs/<blog>/posts/ and it's live on GitHub Pages (or anywhere) seconds later.

Highlights

  • Background service that watches ~/Blogs, where every folder is an independent blog
  • GitHub Pages with no manual steps: folderblog new myblog creates the repo and switches on Pages on first publish; custom domains and HTTPS included
  • Logs in through your own GitHub App (device flow); the login renews itself, and you're notified if it expires
  • No front matter needed: title, date and URL are worked out from the file
  • Safe publishing: fresh builds swap in only on success, so a broken template never takes the site down
  • Jinja themes with an AGENTS.md contract, so coding agents can design anything
  • preview (live reload), check (file:line errors, feed validation, broken links), data, fixture content for theme testing

Install (x86_64 Linux)

System Command
Arch / Omarchy sudo pacman -U folderblog-bin-0.1.0-1-x86_64.pkg.tar.zst
Debian / Ubuntu sudo apt install ./folderblog_0.1.0-1_amd64.deb
Fedora / RHEL / openSUSE sudo dnf install ./folderblog-0.1.0-1.x86_64.rpm
Anything else unpack folderblog-0.1.0-x86_64-linux.tar.gz and put folderblog on your PATH

The binary is fully static, so it runs on older distros too (tested on Ubuntu 22.04, Debian 12, Fedora, Arch). Then follow Preparing GitHub, a one-time, 5-minute setup.

Verify downloads with sha256sum -c SHA256SUMS.

Assets 7
Loading