PieCrust is a static website generator and lightweight CMS that's all managed with text files. No complex setup, databases, or administrative panels. Simple, beautiful, and yummy.

For more information, along with the complete documentation, visit the official website.


If you want to quickly give it a spin:

_piecrust/chef serve --root website

It should start your default browser and show you the sample website. You can then edit files and see what changes.

When you're happy, run _piecrust/chef bake --root website to generate the final static website, which you'll find in website/_counter.


There are 2 branches:

  • default (in mercurial) or master (in `git): that's the development branch. Everything in there is the very latest stuff, which means it may be broken, it may have backwards incompatible changes, and probably has secret undocumented features.

  • stable (in mercurial) or git-stable (in git): that's the, well, stable branch. It has all the latest bug-fixes, but new features and breaking changes are only introduced after some time being tested in the main branch. Also, this branch has version tags whenever changes are committed.


Check out the CHANGELOG file for new features, bug fixes and breaking changes.