Theme Studio is where the visual presentation of a passport is designed. It controls how the passport looks — fonts, colour tokens, spacing, and layout — without affecting what content the passport carries.
Themes are expressed as a closed set of design tokens — colour, typography, spacing, radius, and elevation — bound to semantic roles. Editors change the tokens; the renderer applies them consistently across every section.
The Theme engine operates on a pre-assembled presentation payload. It performs no database joins of its own at render time. This boundary is what allows the same theme to render identically across:
See the unified theme engine ADR for the full contract.
Each workspace has a default theme assigned during the Setup Wizard. New passports inherit this theme unless overridden at the product or batch level.
Themes are saved as drafts and published explicitly. Publishing a theme does not retroactively alter previously published passports — passports are immutable snapshots and must be re-published to pick up theme changes.