You can select a theme for the generated gallery with --theme <name>. Themes don’t impact the way thumbnails are generated, and simply change the final layout of the galleries.

To submit a theme, please raise an issue on Github here.


In this theme, each album is represented as a strip of small thumbnails.

See demo


This theme uses a larger layout, with one large image per album.

See demo


This is theme was the default layout of thumbsup v1. Each album is represented as a 2x2 square of previews.

See demo

Customizing a theme

You can customise the look of a gallery by using --css <file>. Your stylesheet will be rendered at the end of the site’s <head>, which means you can override any part of theme you want. Just make sure the rules are specific enough to take effect. For example:

thumbsup --theme default --css custom.less
// custom.less
.albums li {
  box-shadow: 1px 2px rgba(0, 0, 0, 0.3);

The file can be any valid CSS or LESS. Note you don’t need to copy the file to the output folder, as it’s automatically concatenated with the rest of the theme.

Next: deployment