Build themes

A theme controls how a public storefront looks and renders. Themes are written in Twig. Designers publish public themes to the Stayblox marketplace with the Stayblox CLI; hosts who want a bespoke look can instead upload a .zip as a private custom theme for their own storefront.

Building an integration instead? That's a different surface → Build apps.

How a storefront renders a theme

 You (author)
     │  stayblox theme push  (CLI: draft → review → approved)
     │  …or upload a .zip in the admin (private custom theme)
     ▼
 Theme (marketplace catalog)  ──versioned──▶  ThemeVersion  ──contains──▶  files
     │  host installs
     ▼
 Site theme (per site)  ──copied, editable──▶  files + settings
     │  one is marked active
     ▼
 Storefront request ──▶ active theme's templates render via Twig

• You author a theme; published versions live in the marketplace catalog as versioned, immutable file sets.
• A host installs it: Stayblox copies the version's files into site-level, editable theme files and a settings record.
• On each storefront request, the active theme's templates are resolved and rendered by Twig. Host edits and settings never affect the marketplace original.

Two ways to publish

Path	For	How
Marketplace	Designers selling public themes	CLI: validate → push (private draft) → submit → review → approved
Custom theme	Hosts skinning their own storefront	Upload a .zip in the admin — no review, private to your site

What you work with

• Templates in Twig — with a fixed set of globals, functions, and filters.
• Settings you declare so hosts can customise the theme without code.
• Assets (CSS/JS/images/fonts) served from a stable URL.

Where to go next

• Getting started — scaffold, preview, and validate a minimal theme.
• Theme structure — the package layout and manifest.
• Templating — everything available in templates.
• Theme settings — declare host-configurable options.
• Assets — serve and reference CSS/JS/images.
• Stayblox CLI — install, authenticate, and the theme commands.
• Publishing — marketplace review flow and custom zip upload.