Fork me on GitHub

Creating Themes

Theme Overview

The compiled CSS gets included when Zazu is launched. Be sure to include a zazu.json file in the root of your project with the following information:

  "name": "Light Theme",
  "stylesheet": "dist/main.css"


  • stylesheet string: A relative path to the CSS to be used when displaying the Zazu window.

Previewing your theme

A theme playbook exists so you can preview your Zazu theme with a few of the basic cases.

Take a look at some of the other themes on the packages page for some inspiration.

Using your theme

Just add your relative path to your GitHub repo inside of your personal configuration.

Draggable Regions

Zazu tries to be as small as possible, for this reason we don’t have a title bar, so themes need to implement “draggable” regions. That way users can reposition Zazu if they need to. To define a draggable region you can add some CSS to your theme.

body {
  -webkit-app-region: drag;
input {
  -webkit-app-region: no-drag;

Submitting your theme

Once you finish, submit it to the themes page by making a package file in the documentation