Quick Start for Theme-Developers

You are a professional and don't want to read the whole documentation? No problem, this is all you need to know to create your own theme for TYPEMILL.

Theme Folder

You will find all themes in the theme folder of TYPEMILL. You can add a new folder for your theme there. The name of your folder is the name of your theme.

Change Theme

You can change the theme for typemill in the settings.yaml, that you will find in the settings-folder. Simply add the name of the theme there.

Theme Structure

There is no theme structure. There are only two files that are required:

There is another optional template:

And there are two other files your theme should have:

It is always a good idea to structure your files a bit more. For example, you can create a folder called partials with separate files for different layouts (maybe a folder and file layout?), a navigation, a header, a footer or whatever you want. But this decision is completely up to you. The same with CSS, JavaScript and other ressources: It is a good practice to create separate folders for that, but it is up to you.


The themeName.yaml must have the same name as your theme folder. It should look like this:

name: My Theme Name
version: 1.0.0
description: Write what you want
author: Your name here
homepage: http://an-info-website-for-the-theme.com
licence: MIT


TYPEMILL uses Twig as a template language. You are probably familiar with it. If not: Twig is a widespread template language, that is very easy to learn. It is shorter and safer to use than pure PHP.

Template Variables

There are exactly six template variables to fill your templates with dynamic content:

You can print out each variable with the twig-tag {{ dump(navigation) }} and inspect the content. This is probably the easiest way to familiarize with the possibilities for themes.

Asset Tags

Plugin-Developers want to add CSS and JavaScript into your theme. You should enable plugin-developers to do so with two Twig-tags:


If you create a theme, make sure that all content types are styled correctly. You can use the markdown-test-page to check the styling of all content-elements.

Read more

If you are not ready to start with these information, then please read the full developer manual. In less than one hour you can develop with TYPEMILL like a pro.

Happy coding!