Changing the Theme

The site comes with a very simple default theme by default; you can play around with it, but it's not meant for long-term use. Let's download and install a more interesting theme, notepad.

Download the Theme

All versions of the theme can be downloaded from the releases section of the base site repository, here:

Click on the latest release and download the file named like notepad_theme.<version>.dist.zip.

Create a Directory

In your site's folder, find the subfolder config/themes. Inside it, create a folder named notepad and extract the contents of the downloaded archive into it. You should end up with two folders: templates and assets there. The final folder structure should look like this:

site
   |
   config
        |
        themes
              |
              bland     ← default theme
              |
              notepad
                    |
                    templates
                    assets

Site Configuration

Open the configuration file site/config/site.yaml, find the line:

theme: bland

And change it to:

theme: notepad

Now you can run Mukha in preview mode or generate static files — the new theme should be applied.

If something went wrong