Jolli Themes

Community themes for Jolli documentation sites.

Each theme is a self-contained directory with layout, CSS, and a manifest that the Jolli CLI (jolli dev, jolli build) picks up automatically.

Install a theme via the Jolli CLI:

jolli theme install <name>

Themes are downloaded to ~/.jolli/themes/<name>/.

To use an installed theme, set it in your site.json:

{
  "theme": {
    "pack": "<name>"
  }
}

jolli theme list

Shows all available themes, installed versions, and available updates.

jolli theme preview <name>

Downloads the theme (if not already installed) and launches a local dev server with demo content.

Each theme directory contains four files:

<theme-name>/
  manifest.mjs   # Version, name, and metadata
  index.mjs      # Entry point — exports layout, CSS, and components
  layout.mjs     # React layout component (navbar, sidebar, footer)
  css.mjs        # CSS string for theme-specific styles

export default {
  name: "my-theme",
  version: "1.0.0",
  description: "A short description of the theme",
};

The entry point that re-exports the theme's layout and CSS:

export { default as layout } from "./layout.mjs";
export { default as css } from "./css.mjs";

1. Create a directory under your fork with the theme name.
2. Add manifest.mjs, index.mjs, layout.mjs, and css.mjs.
3. Add the theme to registry.json with a matching version.
4. Run the validation workflow to verify: node .github/workflows/validate.yml (or push to trigger CI).
5. Submit a pull request.

See CONTRIBUTING.md for the full contribution workflow.

Apache License 2.0