Theme
Theme bundle used by the design system. In design.theme, 'id' resolves a themes catalog record as the base; any sibling fields override the resolved theme. The string shorthand on design.theme is equivalent to…
Metadata
#/$defs/Theme
object
spec/schemas/opf.schema.json
Fields
| Field | Type | Req | Description |
|---|---|---|---|
| id | string | — | Theme reference. Resolves to the 'id' of a 'themes' catalog record. Accepts a bare id (lowercase kebab-case, e.g. 'minimal'), an HTTPS URL pointing at a record file, or a 'pkg:' reference. Field overrides on the surrounding Theme object take precedence over the resolved theme. R… |
| name | string | — | Human-readable theme name shown in pickers. |
| summary | string | — | One-sentence positioning of the theme - when to reach for it. |
| description | string | — | Longer prose describing what the theme looks and feels like and the kinds of decks it suits. |
| colorScheme | string | ref:ColorScheme | — | Default color scheme for this theme. A string resolves against catalogs.colorSchemes; an object may provide an 'id' base reference plus overrides. |
| fontScheme | string | ref:FontScheme | — | Default font scheme for this theme. A string resolves against catalogs.fontSchemes; an object may provide an 'id' base reference plus overrides. |
| background | ref:BackgroundShortcut | ref:Background | — | Default background for this theme. String shorthand accepts theme slots ('light1', 'light2', 'dark1', 'dark2') or hex colors. |
| dimensions | ref:DimensionPreset | ref:Dimensions | — | Default slide size for this theme. A string preset is equivalent to { preset: value }. |
| tags | array<string> | — | Free-form labels for filtering and search. |
id
Type: string · Optional · Default: —
Theme reference. Resolves to the 'id' of a 'themes' catalog record. Accepts a bare id (lowercase kebab-case, e.g. 'minimal'), an HTTPS URL pointing at a record file, or a 'pkg:' reference. Field overrides on the surrounding Theme object take precedence over the resolved theme. R…
{
"id": "minimal"
}name
Type: string · Optional · Default: —
Human-readable theme name shown in pickers.
{
"name": "Minimal"
}summary
Type: string · Optional · Default: —
One-sentence positioning of the theme - when to reach for it.
{
"summary": "summary-value"
}description
Type: string · Optional · Default: —
Longer prose describing what the theme looks and feels like and the kinds of decks it suits.
{
"description": "description-value"
}colorScheme
Type: string | ref:ColorScheme · Optional · Default: —
Default color scheme for this theme. A string resolves against catalogs.colorSchemes; an object may provide an 'id' base reference plus overrides.
{
"colorScheme": "cool-horizon"
}fontScheme
Type: string | ref:FontScheme · Optional · Default: —
Default font scheme for this theme. A string resolves against catalogs.fontSchemes; an object may provide an 'id' base reference plus overrides.
{
"fontScheme": "aptos"
}background
Type: ref:BackgroundShortcut | ref:Background · Optional · Default: —
Default background for this theme. String shorthand accepts theme slots ('light1', 'light2', 'dark1', 'dark2') or hex colors.
{
"background": "dark1"
}dimensions
Type: ref:DimensionPreset | ref:Dimensions · Optional · Default: —
Default slide size for this theme. A string preset is equivalent to { preset: value }.
{
"dimensions": "widescreen"
}