Developer Documentation

If you're interested in creating a new theme or want to learn how to modify one of the existing Publii themes for your needs, then this is the right place for you!

Publii uses Handlebars to render its themes, which offers a large amount of flexibility and opportunities to create diverse pages on your website.

We recommend that newcomers start with the how to install a new theme in Publii tutorial followed by our Handlebars introduction, both of which will ground you in the basics of Publii theming.

If you are creating a custom theme, then both the articles on the theme config.json file and the theme structure will be useful.

For users that want an easy way to get started with building a Publii theme, you can try out the Starter theme included with the main package; this theme is specifically designed to be flexible and adaptable; the perfect way to start your Publii theme development adventure!

Download GitHub

It is also worth knowing how the Publii theme renderer works.

Every type of page available in Publii includes their tags. On every page, you can make use global variables and partials which are handy if you want to reuse your theme code.

We have extended the Handlebars API with many custom helpers which can help you to reduce the amount of code used in your theme.

In the tips and tricks section, you will find a lot of articles covering the additional features available in Publii- this article base is still growing, and we are excited to use it to share our knowledge with Publii theme developers.