pageBackgroundpageBackground | color | — | The solid colour behind the whole page Paints the page with one flat colour behind every control. |
|---|
tabBarBackgroundtabBarBackground | color | — | The colour of the bottom tab bar Fills the tab bar strip with this colour. |
|---|
tabBarTinttabBarTint | color | — | The colour of the selected tab Tints the selected tab icon and label; when unset the accent colour is used. |
|---|
surfacePrimarysurfacePrimary | color | — | The colour of cards and controls Fills cards and control backgrounds with this colour. |
|---|
surfaceSecondarysurfaceSecondary | color | — | The colour of things inside a card Fills surfaces nested inside a card, one level deeper than the card itself. |
|---|
surfaceTertiarysurfaceTertiary | color | — | The colour of the deepest layer Fills the deepest nested surfaces, such as wells inside nested cards. |
|---|
accentColoraccentColor | color | — | Your main highlight colour Colours gauges, toggles, sliders and other highlights, and the toggle, slider, stepper and progress tracks follow it unless they set their own. |
|---|
foregroundColorforegroundColor | color | — | The main text colour Draws primary text and icons in this colour; by default white in dark mode and black in light mode. |
|---|
onAccentonAccent | color | — | Text colour on top of accent fills Draws the text or icon on a filled accent button or band; unset, it picks white or black for the best contrast on each fill. |
|---|
secondaryColorsecondaryColor | color | — | The softer text colour Draws secondary text such as captions and sub-labels in this colour. |
|---|
tertiaryColortertiaryColor | color | — | The faintest text colour Draws the least prominent text, such as hints, in this colour. |
|---|
borderColorborderColor | color | — | The colour of card outlines Strokes the outline of cards and controls in this colour. |
|---|
statusOKstatusOK | color | — | The good or success colour Colours success states such as a status light that is on, a good change and success log lines. |
|---|
statusWarnstatusWarn | color | — | The warning colour Colours warning states such as warn log lines and attention markers. |
|---|
statusErrorstatusError | color | — | The error colour Colours error states such as a status light that is off, a bad change and error log lines. |
|---|
statusInfostatusInfo | color | — | The information colour Colours info log lines and other neutral notices. |
|---|
scrimColorscrimColor | color | — | The dimming colour behind pop-ups Dims the content behind chips, sheets and overlays; by default black at 35 percent in dark mode and white at 60 percent in light mode. |
|---|
pageBackgroundGradientpageBackgroundGradient | string[] | — | A blend of colours behind the page Paints the page with a gradient running from top-left to bottom-right through the listed colours. |
|---|
accentGradientaccentGradient | string[] | — | A blend of colours for highlights Fills accent areas with a gradient through the listed colours instead of one flat accent. |
|---|
borderWidthborderWidth | number0–6step 0.5 | — | How thick card outlines are Sets the stroke width of card and control outlines, with 0 meaning no outline. |
|---|
cornerRadiuscornerRadius | number0–40 ptstep 1 | 12 | How round the corners are Rounds every card and control by this many points, and the smaller radii derive from it unless set. |
|---|
controlPaddingcontrolPadding | number0–32step 1 | — | Space inside controls Sets the gap between a control's edge and its content, and the spacing rungs derive from it unless set. |
|---|
cardPaddingcardPadding | number0–32 ptstep 1 | 12 | Space inside group cards Sets the gap between a group card's edge and the controls inside it. |
|---|
compactRadiuscompactRadius | number0–40step 1 | — | Corner roundness for small bits Rounds small chips, badges and tick marks; unset, it is a third of the corner radius. |
|---|
controlRadiuscontrolRadius | number0–40step 1 | — | Corner roundness for buttons and fields Rounds buttons, fields and inner controls; unset, it is two thirds of the corner radius. |
|---|
cardRadiuscardRadius | number0–40step 1 | — | Corner roundness for cards Rounds group cards and containers; unset, it follows the corner radius. |
|---|
compactSpacingcompactSpacing | number0–32step 1 | — | The tightest gap Sets small gaps inside a control; unset, it is half the control padding. |
|---|
standardSpacingstandardSpacing | number0–48step 1 | — | The normal gap Sets the default gap between the parts of a control; unset, it equals the control padding. |
|---|
sectionSpacingsectionSpacing | number0–64step 1 | — | The big gap between sections Sets the gap between groups or sections; unset, it is twice the control padding. |
|---|
emphasizedBorderWidthemphasizedBorderWidth | number0–8step 0.5 | — | The thicker outline for emphasis Sets the stroke width used for emphasised lines such as chart outlines, heavier than the normal border. |
|---|
labelFontSizelabelFontSize | number8–32step 1 | — | Size of label text Sets the size of control labels in points. |
|---|
valueFontSizevalueFontSize | number8–72step 1 | — | Size of value text Sets the size of values shown on controls in points. |
|---|
readoutFontSizereadoutFontSize | number8–96step 1 | — | Size of the big number Sets the size of the main readout in gauges and stat values in points. |
|---|
captionFontSizecaptionFontSize | number8–24step 1 | — | Size of small print Sets the size of captions and small print in points. |
|---|
blurEnabledblurEnabled | on / off | — | Frosted-glass blur on or off Turns the blurred glass material behind cards on or off; off gives flat surfaces. |
|---|
accentaccent | color | — | Pick one accent colour for the whole layout Sets the accent from a colour name or hex, over the theme pack but under a control's own look. |
|---|
surfacesurface | choiceone of 3 | — | Glass, flat or paper cards Switches the card material for the whole layout. - glassfrosted translucent cards, the default look
- solidflat opaque grey cards with the blur turned off
- paperwarm cream cards with the blur off and a hairline border
|
|---|
cornerscorners | choiceone of 3 | — | Sharp, soft or round corners Sets one corner shape for the whole layout, and the smaller radii follow it. - sharp4 pt corners
- soft12 pt corners
- round22 pt corners
|
|---|
typetype | choiceone of 4 | — | The type style for the whole layout Switches every text to one type design, replacing a custom font family. - systemthe normal system font
- roundeda rounded system font
- serifa serif font
- monoa monospaced font
|
|---|
densitydensity | number0.7–1.5step 0.05 | — | How roomy or tight things are Scales the control and card padding by this factor, so 0.7 is tighter and 1.5 is roomier. |
|---|
fontFamilyfontFamily | text | — | A custom font by name Draws text in the named font family instead of the system font. |
|---|
fontDesignfontDesign | choiceone of 4 | — | The look of the system font Switches the system font between its default, rounded, serif and monospaced designs. - defaultthe normal system design
- roundeda rounded design
- serifa serif design
- monospaceda fixed-width design
|
|---|
valueFontWeightvalueFontWeight | text | — | How bold value text is Sets the weight of value text, for example semibold or bold. |
|---|
toggletoggle | object | — | Restyle every toggle Holds the toggle look keys that apply to all toggles in this scope. |
|---|
sliderslider | object | — | Restyle every slider Holds the slider look keys that apply to all sliders in this scope. |
|---|
stepperstepper | object | — | Restyle every stepper Holds the stepper look keys that apply to all steppers in this scope. |
|---|
segmentedsegmented | object | — | Restyle every segmented picker Holds the segmented look keys that apply to all segmented pickers in this scope. |
|---|
progressBarprogressBar | object | — | Restyle every progress bar Holds the progress bar look keys that apply to all progress bars in this scope. |
|---|
lightlight | object | — | Colours used only in light mode Applies these colour overrides last, only while the app is showing light mode. |
|---|
darkdark | object | — | Colours used only in dark mode Applies these colour overrides last, only while the app is showing dark mode. |
|---|
palettepalette | object | — | Name your colours once Defines named colours that any colour field can reuse as a dollar-name reference. |
|---|
primarypalette.primary | color | — | Your main colour role Colours every slot that defaults to primary (a gauge arc, a button fill); unset, it is the accent colour. |
|---|
secondarypalette.secondary | color | — | A second colour for two-tone controls Colours slots and series entries that name secondary; unset, it is the primary colour. |
|---|
tertiarypalette.tertiary | color | — | A third colour for series and accents Colours slots and series entries that name tertiary; unset, it is the secondary colour. |
|---|
neutralpalette.neutral | color | — | The quiet colour for tracks and ticks Colours slots that default to neutral, such as tracks and grid lines at their own opacity; unset, it is the foreground colour. |
|---|
pageBackgroundschemeOverride.pageBackground | color | — | The solid colour behind the whole page in this mode When the app is in this block's mode, paints the page with one flat colour behind every control. |
|---|
tabBarBackgroundschemeOverride.tabBarBackground | color | — | The colour of the bottom tab bar in this mode When the app is in this block's mode, fills the tab bar strip with this colour. |
|---|
tabBarTintschemeOverride.tabBarTint | color | — | The colour of the selected tab in this mode When the app is in this block's mode, tints the selected tab icon and label; when unset the accent colour is used. |
|---|
surfacePrimaryschemeOverride.surfacePrimary | color | — | The colour of cards and controls in this mode When the app is in this block's mode, fills cards and control backgrounds with this colour. |
|---|
surfaceSecondaryschemeOverride.surfaceSecondary | color | — | The colour of things inside a card in this mode When the app is in this block's mode, fills surfaces nested inside a card, one level deeper than the card itself. |
|---|
surfaceTertiaryschemeOverride.surfaceTertiary | color | — | The colour of the deepest layer in this mode When the app is in this block's mode, fills the deepest nested surfaces, such as wells inside nested cards. |
|---|
accentColorschemeOverride.accentColor | color | — | Your main highlight colour in this mode When the app is in this block's mode, colours gauges, toggles, sliders and other highlights, and the toggle, slider, stepper and progress tracks follow it unless they set their own. |
|---|
foregroundColorschemeOverride.foregroundColor | color | — | The main text colour in this mode When the app is in this block's mode, draws primary text and icons in this colour; by default white in dark mode and black in light mode. |
|---|
onAccentschemeOverride.onAccent | color | — | Text colour on top of accent fills in this mode When the app is in this block's mode, draws the text or icon on a filled accent button or band; unset, it picks white or black for the best contrast on each fill. |
|---|
secondaryColorschemeOverride.secondaryColor | color | — | The softer text colour in this mode When the app is in this block's mode, draws secondary text such as captions and sub-labels in this colour. |
|---|
tertiaryColorschemeOverride.tertiaryColor | color | — | The faintest text colour in this mode When the app is in this block's mode, draws the least prominent text, such as hints, in this colour. |
|---|
borderColorschemeOverride.borderColor | color | — | The colour of card outlines in this mode When the app is in this block's mode, strokes the outline of cards and controls in this colour. |
|---|
statusOKschemeOverride.statusOK | color | — | The good or success colour in this mode When the app is in this block's mode, colours success states such as a status light that is on, a good change and success log lines. |
|---|
statusWarnschemeOverride.statusWarn | color | — | The warning colour in this mode When the app is in this block's mode, colours warning states such as warn log lines and attention markers. |
|---|
statusErrorschemeOverride.statusError | color | — | The error colour in this mode When the app is in this block's mode, colours error states such as a status light that is off, a bad change and error log lines. |
|---|
statusInfoschemeOverride.statusInfo | color | — | The information colour in this mode When the app is in this block's mode, colours info log lines and other neutral notices. |
|---|
scrimColorschemeOverride.scrimColor | color | — | The dimming colour behind pop-ups in this mode When the app is in this block's mode, dims the content behind chips, sheets and overlays; by default black at 35 percent in dark mode and white at 60 percent in light mode. |
|---|
pageBackgroundGradientschemeOverride.pageBackgroundGradient | string[] | — | A blend of colours behind the page in this mode When the app is in this block's mode, paints the page with a gradient running from top-left to bottom-right through the listed colours. |
|---|
accentGradientschemeOverride.accentGradient | string[] | — | A blend of colours for highlights in this mode When the app is in this block's mode, fills accent areas with a gradient through the listed colours instead of one flat accent. |
|---|
trackColortoggle.trackColor | color | — | Toggle colour when off Fills the toggle's track while the switch is off. |
|---|
trackActiveColortoggle.trackActiveColor | color | — | Toggle colour when on Fills the toggle's track while the switch is on; it follows the accent when unset. |
|---|
trackRadiustoggle.trackRadius | number0–30step 1 | — | How round the toggle track is Rounds the corners of the toggle's track. |
|---|
trackHeighttoggle.trackHeight | number8–60step 1 | — | How tall the toggle is Sets the height of the toggle's track in points. |
|---|
trackWidthtoggle.trackWidth | number20–100step 1 | — | How wide the toggle is Sets the width of the toggle's track in points. |
|---|
knobColortoggle.knobColor | color | — | Knob colour when off Fills the sliding knob while the switch is off. |
|---|
knobActiveColortoggle.knobActiveColor | color | — | Knob colour when on Fades the knob to this colour as the switch moves to on. |
|---|
knobRadiustoggle.knobRadius | number0–30step 1 | — | How round the knob is Rounds the corners of the toggle's knob. |
|---|
knobSizetoggle.knobSize | number8–50step 1 | — | How big the knob is Sets the diameter of the toggle's knob in points. |
|---|
knobShadowtoggle.knobShadow | on / off | — | Shadow under the knob Draws or hides a soft shadow beneath the toggle knob. |
|---|
trackColorslider.trackColor | color | — | Slider track colour Fills the unfilled part of the slider's track. |
|---|
trackActiveColorslider.trackActiveColor | color | — | Slider filled colour Fills the part of the slider's track up to the thumb; it follows the accent when unset. |
|---|
trackRadiusslider.trackRadius | number0–10step 1 | — | How round the slider track is Rounds the corners of the slider's track. |
|---|
trackHeightslider.trackHeight | number2–20step 1 | — | How thick the slider track is Sets the height of the slider's track in points. |
|---|
thumbColorslider.thumbColor | color | — | Slider handle colour Fills the draggable thumb of the slider. |
|---|
thumbRadiusslider.thumbRadius | number0–20step 1 | — | How round the handle is Rounds the corners of the slider's thumb. |
|---|
thumbSizeslider.thumbSize | number8–40step 1 | — | How big the handle is Sets the diameter of the slider's thumb in points. |
|---|
thumbShadowslider.thumbShadow | on / off | — | Shadow under the handle Draws or hides a soft shadow beneath the slider thumb. |
|---|
thumbBorderColorslider.thumbBorderColor | color | — | Outline colour of the handle Strokes the edge of the slider thumb in this colour. |
|---|
thumbBorderWidthslider.thumbBorderWidth | number0–6step 0.5 | — | Outline thickness of the handle Sets how thick the thumb's outline is; 0 draws none. |
|---|
buttonColorstepper.buttonColor | color | — | Stepper button colour Fills the plus and minus buttons; it follows the accent when unset. |
|---|
buttonRadiusstepper.buttonRadius | number0–30step 1 | — | How round the stepper buttons are Rounds the corners of the plus and minus buttons. |
|---|
buttonSizestepper.buttonSize | number20–64step 1 | — | How big the stepper buttons are Sets the size of the plus and minus buttons in points. |
|---|
iconColorstepper.iconColor | color | — | Colour of the plus and minus Draws the plus and minus symbols in this colour. |
|---|
stylestepper.style | text | — | Which stepper layout to use Names a stepper layout variant, horizontal unless set. |
|---|
trackColorsegmented.trackColor | color | — | Segmented picker background Fills the strip behind all the segments. |
|---|
trackRadiussegmented.trackRadius | number0–30step 1 | — | How round the strip is Rounds the corners of the strip behind the segments. |
|---|
selectedColorsegmented.selectedColor | color | — | Colour of the chosen segment Fills the pill behind the selected segment. |
|---|
selectedRadiussegmented.selectedRadius | number0–30step 1 | — | How round the chosen pill is Rounds the corners of the selected segment's pill. |
|---|
selectedShadowsegmented.selectedShadow | on / off | — | Shadow under the chosen segment Draws or hides a soft shadow beneath the selected segment's pill. |
|---|
textColorsegmented.textColor | color | — | Text colour of unchosen segments Draws the labels of segments that are not selected. |
|---|
selectedTextColorsegmented.selectedTextColor | color | — | Text colour of the chosen segment Draws the selected segment's label; unset, it picks black or white to suit the pill. |
|---|
trackColorprogressBar.trackColor | color | — | Progress bar background Fills the empty part of the progress bar. |
|---|
trackActiveColorprogressBar.trackActiveColor | color | — | Progress bar fill colour Fills the completed part of the progress bar; it follows the accent when unset. |
|---|
trackRadiusprogressBar.trackRadius | number0–20step 1 | — | How round the bar is Rounds the corners of the progress bar's track. |
|---|
trackHeightprogressBar.trackHeight | number2–30step 1 | — | How thick the bar is Sets the height of the progress bar in points. |
|---|