Juice is an intuitive, elegant, and responsive Zola theme for product sites.



First download this theme to your themes directory:

$ cd themes
$ git clone https://github.com/huhu/juice.git

or add as a submodule

$ git submodule add https://github.com/huhu/juice  themes/juice

and then enable it in your config.toml:

theme = "juice"



Juice is designed for product websites, hence we let hero part fills whole of screen. You can customize your hero by using hero block in the index.html.

{%/* extends "juice/templates/index.html" */%}
{%/* block hero */%}
        Your cool hero html...
{%/* endblock hero */%}


Every markdown file located in content directory will become a Page. There also will display as a navigate link on the top-right corner. You can change the frontmatter's weight value to sort the order (ascending order).

title = "Changelog"
description = "Changelog"
weight = 2

CSS variables

You can override theme variable by creating a file named _variables.html in your templates directory.

    :root {
        /* Primary theme color */
        --primary-color: #FED43F;
        /* Primary theme text color */
        --primary-text-color: #543631;
        /* Primary theme link color */
        --primary-link-color: #F9BB2D;
        /* Secondary color: the background body color */
        --secondary-color: #fcfaf6;
        --secondary-text-color: #303030;
        /* Highlight text color of table of content */
        --toc-highlight-text-color: #d46e13;


{%/* extends "juice/templates/index.html" */%}
{%/* block favicon */%}
    <link rel="icon" type="image/png" href="/favicon.ico">
{%/* endblock favicon */%}


You can customize some builtin property in config.toml file:

juice_logo_name = "Juice"
juice_logo_path = "juice.svg"
juice_extra_menu = [
    { title = "Github", link = "https://github.com/huhu/juice"}
repository_url = "https://github.com/huhu/juice"


Juice have some builtin shortcodes available in templates/shortcodes directory.

The repository_url is required.


Please see the showcases page.


Thank you very much for considering contributing to this project!

We appreciate any form of contribution: