This is the complete reference for all theme properties. Use it alongside the custom themes guide.
Theme metadata
Property Type Description idstring Unique identifier for the theme namestring Display name descriptionstring Optional description
{
id: 'my-theme' ,
name: 'My Theme' ,
description: 'A brief description' ,
}
Header
Controls the top navigation bar.
Property Type Description backgroundColorcolor Top bar background iconColorcolor Home button and settings icon textColorcolor Remaining time text timeFontSizestring Remaining time font size timeFontWeightstring Remaining time font weight progressBar.backgroundColorcolor Progress track (unfilled) progressBar.highlightColorcolor Progress fill (completed)
header: {
backgroundColor: '#FFFFFF' ,
iconColor: '#6366F1' ,
textColor: '#111827' ,
timeFontSize: '14px' ,
timeFontWeight: '600' ,
progressBar: {
backgroundColor: '#E5E7EB' ,
highlightColor: '#6366F1' ,
},
}
Main content
Property Type Description backgroundColorcolor Background behind all content
mainContent: {
backgroundColor: '#F9FAFB' ,
}
Cards
Controls all content cards (audio stops, text, email, rating).
Property Type Description backgroundColorcolor Card background textColorcolor Main text color borderColorcolor Card border borderRadiusstring Corner rounding (e.g., '12px') shadowstring Drop shadow titleFontSizestring Card title size titleFontWeightstring Card title weight durationBadgeFontSizestring Duration badge font size numberFontSizestring Step number size numberFontWeightstring Step number weight image.placeholderColorcolor Image loading placeholder image.durationBadgeBackgroundcolor Badge overlay on images image.durationBadgeTextcolor Badge text color
cards: {
backgroundColor: '#FFFFFF' ,
textColor: '#111827' ,
borderColor: '#E5E7EB' ,
borderRadius: '12px' ,
shadow: '0 2px 15px rgba(0,0,0,0.1)' ,
titleFontSize: '18px' ,
titleFontWeight: '600' ,
durationBadgeFontSize: '14px' ,
numberFontSize: '14px' ,
numberFontWeight: '600' ,
image: {
placeholderColor: '#E5E7EB' ,
durationBadgeBackground: 'rgba(0,0,0,0.6)' ,
durationBadgeText: '#FFFFFF' ,
},
}
Step indicators
Controls the circular progress indicators.
Active (current step)
Property Type Description outlineColorcolor Circle border numberColorcolor Number text backgroundColorcolor Circle fill
Inactive (future steps)
Property Type Description borderColorcolor Circle border numberColorcolor Number text backgroundColorcolor Circle fill
Completed
Property Type Description backgroundColorcolor Circle fill (solid) checkmarkColorcolor Checkmark icon
stepIndicators: {
active: {
outlineColor: '#6366F1' ,
numberColor: '#6366F1' ,
backgroundColor: '#EEF2FF' ,
},
inactive: {
borderColor: '#E5E7EB' ,
numberColor: '#9CA3AF' ,
backgroundColor: '#F9FAFB' ,
},
completed: {
backgroundColor: '#6366F1' ,
checkmarkColor: '#FFFFFF' ,
},
}
Buttons
Primary button
Used for main actions (Start Tour, Continue, Submit).
Property Type Description backgroundColorcolor Button background textColorcolor Button text hoverBackgroundcolor Background on press/hover iconColorcolor Icon color fontSizestring Text size fontWeightstring Text weight fontFamilystring[] Optional custom font
Secondary button
Used for secondary actions (Cancel, Skip).
Property Type Description backgroundColorcolor Button background textColorcolor Button text borderColorcolor Button border hoverBackgroundcolor Background on press/hover fontSizestring Text size fontWeightstring Text weight fontFamilystring[] Optional custom font
Download button
Full-width outline button for offline download.
Property Type Description backgroundColorcolor Usually 'transparent' textColorcolor Button text borderColorcolor Button border hoverBackgroundcolor Background on press/hover iconColorcolor Download icon fontSizestring Text size fontWeightstring Text weight fontFamilystring[] Optional custom font
Transcription button
Circular button in the mini player.
Property Type Description backgroundColorcolor Button background iconColorcolor Icon color hoverBackgroundcolor Background on press/hover
buttons: {
primary: {
backgroundColor: '#6366F1' ,
textColor: '#FFFFFF' ,
hoverBackground: '#4F46E5' ,
iconColor: '#FFFFFF' ,
fontSize: '18px' ,
fontWeight: '600' ,
},
secondary: {
backgroundColor: '#F9FAFB' ,
textColor: '#111827' ,
borderColor: '#E5E7EB' ,
hoverBackground: '#F3F4F6' ,
fontSize: '16px' ,
fontWeight: '500' ,
},
download: {
backgroundColor: 'transparent' ,
textColor: '#6366F1' ,
borderColor: '#6366F1' ,
hoverBackground: 'rgba(99, 102, 241, 0.1)' ,
iconColor: '#6366F1' ,
fontSize: '18px' ,
fontWeight: '600' ,
},
transcription: {
backgroundColor: '#FFFFFF' ,
iconColor: '#6366F1' ,
hoverBackground: '#F3F4F6' ,
},
}
Typography
Property Type Description fontFamily.sansstring[] Body text font fontFamily.headingstring[] Headlines font (optional) fontFamily.numbersstring[] Numerical display font (optional)
typography: {
fontFamily: {
sans: [ 'Inter' , 'system-ui' , 'sans-serif' ],
heading: [ 'Space Grotesk' , 'Inter' , 'sans-serif' ],
numbers: [ 'Space Grotesk' ],
},
}
Font sizes and weights are defined per-component, not globally. This keeps the theme predictable.
Fonts are bundled with the player: Inter, IBM Plex Sans, Space Grotesk and JetBrains Mono. Nothing is loaded from Google Fonts. See Custom fonts to add another family.
Branding
Property Type Description logoUrlstring Logo image URL (or undefined) showLogoBorderboolean Show border/background around logo logoSize'fit' | 'original'Constrain to 48x48 or use natural size
branding: {
logoUrl: 'https://example.com/logo.svg' ,
showLogoBorder: true ,
logoSize: 'fit' ,
}
Mini player
Controls the floating audio player.
Property Type Description backgroundColorcolor Player background textColorcolor Title and time text titleFontSizestring Track title size titleFontWeightstring Track title weight transcriptionFontSizestring Transcription text size progressBar.backgroundColorcolor Track (unfilled) progressBar.highlightColorcolor Progress fill controls.playButtonBackgroundcolor Play/pause button background controls.playButtonIconcolor Play/pause icon controls.otherButtonsBackgroundcolor Skip buttons background controls.otherButtonsIconcolor Skip buttons icon minimized.playButtonIconcolor Play icon when collapsed
miniPlayer: {
backgroundColor: '#FFFFFF' ,
textColor: '#111827' ,
titleFontSize: '16px' ,
titleFontWeight: '500' ,
transcriptionFontSize: '15px' ,
progressBar: {
backgroundColor: '#E5E7EB' ,
highlightColor: '#6366F1' ,
},
controls: {
playButtonBackground: '#6366F1' ,
playButtonIcon: '#FFFFFF' ,
otherButtonsBackground: '#F3F4F6' ,
otherButtonsIcon: '#6B7280' ,
},
minimized: {
playButtonIcon: '#6366F1' ,
},
}
Sheets (bottom sheets)
Property Type Description backgroundColorcolor Sheet background handleColorcolor Drag handle textColorcolor Text content borderColorcolor Top border titleFontSizestring Sheet title size titleFontWeightstring Sheet title weight
sheets: {
backgroundColor: '#FFFFFF' ,
handleColor: '#D1D5DB' ,
textColor: '#111827' ,
borderColor: '#E5E7EB' ,
titleFontSize: '18px' ,
titleFontWeight: '700' ,
}
Start card
Property Type Description titleFontSizestring Tour title size titleFontWeightstring Tour title weight titleLineHeightstring Tour title line height metaFontSizestring Duration/stops size metaFontWeightstring Duration/stops weight metaColorcolor Duration/stops color descriptionFontSizestring Description size offlineMessage.backgroundColorcolor Offline message background offlineMessage.borderColorcolor Offline message border offlineMessage.textColorcolor Offline message text
startCard: {
titleFontSize: '30px' ,
titleFontWeight: '700' ,
titleLineHeight: '1.2' ,
metaFontSize: '14px' ,
metaFontWeight: '400' ,
metaColor: '#6B7280' ,
descriptionFontSize: '16px' ,
offlineMessage: {
backgroundColor: 'rgba(59, 130, 246, 0.08)' ,
borderColor: 'rgba(59, 130, 246, 0.25)' ,
textColor: '#3b82f6' ,
},
}
Loading states
Property Type Description spinnerColorcolor Loading spinner backgroundColorcolor Loading screen background messageFontSizestring Loading text size messageFontWeightstring Loading text weight
loading: {
spinnerColor: '#6366F1' ,
backgroundColor: '#F9FAFB' ,
messageFontSize: '16px' ,
messageFontWeight: '500' ,
}
Status colors
Property Type Description successcolor Success messages/icons errorcolor Error messages/icons warningcolor Warning messages/icons
status: {
success: '#10B981' ,
error: '#EF4444' ,
warning: '#F59E0B' ,
}
Inputs
Property Type Description backgroundColorcolor Input field background textColorcolor Input text borderColorcolor Default border focusBorderColorcolor Border when focused placeholderColorcolor Placeholder text
inputs: {
backgroundColor: '#FFFFFF' ,
textColor: '#111827' ,
borderColor: '#E5E7EB' ,
focusBorderColor: '#6366F1' ,
placeholderColor: '#9CA3AF' ,
}
Semantic colors
Global color tokens for consistency.
Text
Property Description primaryMain headings, important text secondarySubtitles, supporting text tertiaryMetadata, timestamps inverseText on dark backgrounds
Border
Property Description lightSubtle dividers mediumCard borders, section separators darkEmphasized dividers
Background
Property Description primaryCards, modals, overlays secondaryPage background, sections tertiaryHover states, disabled elements
colors: {
text: {
primary: '#111827' ,
secondary: '#6B7280' ,
tertiary: '#9CA3AF' ,
inverse: '#FFFFFF' ,
},
border: {
light: '#F3F4F6' ,
medium: '#E5E7EB' ,
dark: '#D1D5DB' ,
},
background: {
primary: '#FFFFFF' ,
secondary: '#F9FAFB' ,
tertiary: '#F3F4F6' ,
},
}
Color format
Use hex codes for solid colors:
backgroundColor: '#6366F1'
Use rgba for transparency:
shadow: '0 2px 15px rgba(0, 0, 0, 0.1)'
Avoid using named colors ('blue') or rgb without alpha ('rgb(99, 102, 241)'). Stick to hex and rgba for consistency.
TypeScript interface
The complete type is in src/theme/types.ts:
export interface ThemeConfig {
id : string ;
name : string ;
description ?: string ;
header : HeaderConfig ;
mainContent : MainContentConfig ;
cards : CardsConfig ;
stepIndicators : StepIndicatorsConfig ;
buttons : ButtonsConfig ;
typography : TypographyConfig ;
branding : BrandingConfig ;
miniPlayer : MiniPlayerConfig ;
sheets : SheetsConfig ;
status : StatusConfig ;
loading : LoadingConfig ;
startCard : StartCardConfig ;
inputs : InputsConfig ;
colors : ColorsConfig ;
}
Use this as your reference when creating themes. TypeScript will tell you if you're missing any required properties.