Folia¶
A little more joy in publishing.
Folia is a fast static site generator written in Rust. It reads a git repository of Markdown, templates and one configuration file, and writes a static site you can host anywhere.
Fully vibe coded, and provided as is
An AI assistant (Claude) writes all of Folia's code, tests, scripts and docs, directed and reviewed by the maintainer. It is tested, not audited, so expect rough edges. Folia was started for one website, ggirelli.info, and you are welcome to use it for yours. It is free software under the MIT license, without warranty. The whole story is in About Folia.
What Folia is for¶
Folia is for a personal site that is more than a blog. It has four collections: a blog, a microblog of short notes, likes, bookmarks and RSVPs, a digital garden of notes joined by wiki-links and backlinks, and pages with URLs you choose. It also writes the Atom feeds, the sitemap, search data and redirects.
I wrote it for three things. Speed: folia serve rebuilds as you save and writes only what
changed. Simplicity: one command, one configuration file, one way to go from a Markdown file
to a page. Ownership: your content is plain files in your own git repository, and the output
is a folder of static files you can host anywhere.
Learning path¶
- Install Folia.
- Build your first site: copy the example, edit it live, build it.
- Build and deploy it.
- Learn to write content and shape it with templates, and look up keys in the configuration reference.
Elsewhere in the docs¶
| If you want to | Read |
|---|---|
| preview a site while you write, or schedule a post | Preview while you write, Drafts and scheduling |
| know what the feeds, sitemap and search script do | Feeds, sitemap and search |
| look up a command, a configuration key or what a template sees | Reference |
| move an existing Jekyll site over | Migrating from Jekyll |
| know what Folia does differently from Jekyll, and what it does not do | Differences from Jekyll and known limitations |
| know where it comes from and how it is made | About Folia |
| work on Folia itself | Architecture, Development setup |
Status¶
Folia is pre-1.0: see the release notes. Its output equals Jekyll's for most of the author's site and differs, on purpose or by a known limitation, for the rest, so read Differences from Jekyll before replacing a Jekyll site.
Support¶
Folia is free. If it is useful to you, you can support its upkeep through GitHub Sponsors or Ko-fi. Sponsoring buys no support, features or warranty.