Batoi Press Docs

Themes

Understand how Batoi Press themes structure public layouts, templates, and assets.

Start Reading Open Batoi Press GitHub
On this page

Themes

Themes define how Batoi Press renders public pages and posts. A theme should keep presentation separate from stored content.

Batoi Press theme rendering A workflow showing content and site settings flowing into a theme layout that renders the browser page. Content Settings Theme layout templates Page Theme files can change design without changing stored content.

Theme Goals

  • Keep layout and visual design outside content files.
  • Use reusable templates for pages, posts, navigation, and shared sections.
  • Keep assets under the public web root where the browser can load them.
  • Keep private configuration outside direct public access.

Typical Theme Responsibilities

  • Page shell and header.
  • Navigation and footer.
  • Page and post layouts.
  • Content body rendering.
  • CSS, JavaScript, and image assets.

The default theme uses these layout files:

radpress/theme/default/layouts/base.php
radpress/theme/default/layouts/page.php
radpress/theme/default/layouts/post.php
radpress/theme/default/layouts/blog.php
radpress/theme/default/layouts/archive.php
radpress/theme/default/layouts/404.php
radpress/theme/default/theme.json

Theme layouts receive sanitized content and metadata from the engine.

Design Guidance

Use simple, predictable templates. Batoi Press is intended for compact public sites, not heavy application dashboards. Public themes may use the bundled UIF primitives, but they are not required to.