Skip to main content

Reference · CSS variables

This page documents every --nrn-* variable the widget exposes inside the Shadow DOM. Colors use the RGB-triplet format (no rgb(...) wrapper) to allow runtime alpha composition, e.g.: rgb(var(--nrn-primary) / 0.18).

  • Spacings, radii, shadows, transitions are standard CSS values (rem, ms, 0 4px 6px …).
  • Z-index are integers.
  • Layout dimensions are any CSS length (px, vw, %).

Variables are injected inside .neuroon-widget[data-theme="..."]. Table:

| Variable | Default light | Default dark | |---|---|---|---| | --nrn-surface-base | surfaceBase | 255 255 255 | 15 23 42 | | --nrn-surface-elevated | surfaceElevated | 248 250 252 | 30 41 59 | | --nrn-surface-overlay | surfaceOverlay | 255 255 255 | 30 41 59 | | --nrn-surface-hover | surfaceHover | 241 245 249 | 51 65 85 |

Text

VariableOverrideDefault lightDefault dark
--nrn-text-primarytextPrimary15 23 42248 250 252
--nrn-text-secondarytextSecondary51 65 85203 213 225
--nrn-text-mutedtextMuted100 116 139148 163 184
--nrn-text-disabledtextDisabled148 163 184100 116 139

Border

VariableOverrideDefault lightDefault dark
--nrn-border-defaultborderDefault226 232 24051 65 85
--nrn-border-emphasisborderEmphasis203 213 22571 85 105
--nrn-border-subtleborderSubtle241 245 24930 41 59

Brand primary

VariableOverrideDefault
--nrn-primaryprimary6 182 212 (cyan-500)
--nrn-primary-lightprimaryLight34 211 238 (cyan-400)
--nrn-primary-darkprimaryDark8 145 178 (cyan-600)

The widget also writes legacy variants --color-primary, --color-nrn-primary, --color-primary-hover for compatibility with Tailwind v4 classes generated at build time ( | | --nrn-secondary-light | secondaryLight | 96 165 250 (blue-400) | | --nrn-secondary-dark | secondaryDark | 29 78 216 (blue-700) |

Accent

VariableOverrideDefaultUsage
--nrn-accent-purpleaccentPurple168 85 247 (purple-500)AI suggestions, image search.
--nrn-accent-emeraldaccentEmerald16 185 129 (emerald-500)AI-applied filters, success.
--nrn-accent-amberaccentAmber245 158 11 (amber-500)Warnings, medium confidence.

Semantic

VariableOverrideDefault
--nrn-successsuccess34 197 94 (green-500)
--nrn-errorerror239 68 68 (red-500)
--nrn-warningwarning245 158 11 (amber-500)

Typography

VariableOverrideDefault
--nrn-font-familyfontFamily"Inter", system-ui, sans-serif
--nrn-font-size-xsfontSizeXs0.75rem
--nrn-font-size-smfontSizeSm0.875rem
--nrn-font-size-basefontSizeBase1rem
--nrn-font-size-lgfontSizeLg1.125rem
--nrn-font-size-xlfontSizeXl1.25rem
--nrn-font-size-2xlfontSize2xl1.5rem

Spacing

VariableOverrideDefault
--nrn-spacing-xsspacingXs0.25rem
--nrn-spacing-smspacingSm0.5rem
--nrn-spacing-mdspacingMd1rem
--nrn-spacing-lgspacingLg1.5rem
--nrn-spacing-xlspacingXl2rem

Radius

VariableOverrideDefault
--nrn-radius-smradiusSm0.375rem
--nrn-radius-mdradiusMd0.5rem
--nrn-radius-lgradiusLg0.75rem
--nrn-radius-xlradiusXl1rem
--nrn-radius-2xlradius2xl1.5rem
--nrn-radius-fullradiusFull9999px

Shadow

VariableOverrideDefault
--nrn-shadow-smshadowSm0 1px 2px 0 rgb(0 0 0 / 0.05)
--nrn-shadow-mdshadowMd0 4px 6px -1px rgb(0 0 0 / 0.1)
--nrn-shadow-lgshadowLg0 10px 15px -3px rgb(0 0 0 / 0.1)
--nrn-shadow-xlshadowXl0 20px 25px -5px rgb(0 0 0 / 0.1)

Transitions

VariableOverrideDefault
--nrn-transition-fasttransitionFast150ms ease-in-out
--nrn-transition-basetransitionBase200ms ease-in-out
--nrn-transition-slowtransitionSlow300ms ease-in-out

Z-index

VariableOverrideDefault
--nrn-z-dropdownzDropdown1000
--nrn-z-stickyzSticky1100
--nrn-z-modal-backdropzModalBackdrop1200
--nrn-z-modalzModal1300
--nrn-z-tooltipzTooltip1400

Layout

VariableOverrideDefault
--nrn-container-max-widthcontainerMaxWidth100%
--nrn-filters-max-width-smfiltersMaxWidthSm280px
--nrn-filters-max-width-mdfiltersMaxWidthMd300px
--nrn-filters-max-width-lgfiltersMaxWidthLg320px
--nrn-drawer-widthdrawerWidth380px
--nrn-drawer-max-widthdrawerMaxWidth90vw
--nrn-dropdown-widthdropdownWidth288px
--nrn-dropdown-max-heightdropdownMaxHeight340px
--nrn-suggestions-max-widthsuggestionsMaxWidth100%
--nrn-comparison-panel-widthcomparisonPanelWidth360px
--nrn-comparison-tab-widthcomparisonTabWidth48px

Further reading