Custom Themes

SnappyMail does support custom CSS themes.

The place where the theme should be is [root]/themes where [root] is the root of your SnappyMail installation.

So if you have something like /home/webmail/public_html/snappymail/v/0.0.0/ The custom themes should be in /home/webmail/public_html/themes/.

In there create a theme folder with file styles.css.
Like: [root]/themes/[themename]/styles.css.
You can copy the content of https://github.com/the-djmaze/snappymail/blob/master/snappymail/v/0.0.0/themes/example.css as a start for your custom theme. Or copy from https://github.com/the-djmaze/snappymail/blob/master/snappymail/v/0.0.0/themes/Default/styles.css

You can also use images like:

	--main-bg-image: url("images/background.jpg");

And store the image as [root]/themes/[themename]/images/background.jpg

Every other modification of the SnappyMail UI that can't be done in CSS has to be realized with a plugin. Plugins allow you for example to inject JS Code at the right time. Have a look at the Developer Documentation for more information about this topic.

Caching

Because SnappyMail caches your images and stylesheet, you need to clear up caches to be able to see changes immediately after editing styles.css as well as any other resources of your custom theme. Example if you are using apache:

rm -rf /home/webmail/public_html/data/_data_/_default_/cache && apachectl reload