Themes

A theme controls how Build Pages output looks and behaves.

Build Pages discovers Markdown, reads optional site config, prepares ZeroPress build data, and passes that data to a ZeroPress theme. The theme provides layouts, partials, CSS, JavaScript, navigation markup, search UI, and other presentation details.

Markdown documents + Build Pages config + ZeroPress theme
  -> static HTML output

Bundled Themes

Use --theme to select a bundled theme.

npx --yes @zeropress/build-pages \
  --source ./docs \
  --destination ./_site \
  --theme docs2

Available bundled values:

Value	Meaning	Preview
docs	Default bundled documentation theme. Alias for docs1.	-
docs1	Top-navigation documentation theme for small docs sites, package manuals, short guides, and compact reference pages.	zeropress.dev
docs2	Sidebar documentation theme for larger docs sites with multiple sections, command palette search, page TOC, and collection-based previous/next navigation.	build-pages.zeropress.dev

Bundled theme source files are published in the themes directory.

Custom Themes

Use --theme-path when your project has a local theme directory.

npx --yes @zeropress/build-pages \
  --source ./docs \
  --destination ./_site \
  --theme-path ./theme-docs

--theme-path takes precedence over --theme.

Create A Theme

Use @zeropress/create-theme when you want to scaffold a standalone theme project.

npx @zeropress/create-theme --name my-docs-theme --template docs

The generated theme can be edited locally and passed to Build Pages with --theme-path.

Theme Contract

Build Pages themes are regular ZeroPress themes. They use the same theme.json, template syntax, partials, and asset rules as other ZeroPress themes.

For the full authoring guide, see ZeroPress Theme Authoring.