Augeo AI Docs
Augeo Design SystemFoundations

Color

Primitive ramps, the brand layer a partner replaces, and the semantic roles components read.

Primitive ramps, the brand layer a partner replaces, and the semantic roles components read.

Storybook

Loading

Semantic roles

What a component reads. A role names the job, so re-pointing it re-themes everything asking for that job.

TokenValueNotes
--augds-scrollbar-thumb{color.alpha-black.20}The scrollbar thumb at rest.
--augds-scrollbar-thumb-hover{color.alpha-black.40}The scrollbar thumb while the pointer is over the region.
--augds-scrollbar-tracktransparentThe scrollbar track.
--augds-surface-canvas{color.neutral-zinc.100}The shell behind an app's sidebar and content panel, one step below the page. An app shell reads it, so a white panel shows elevation by fill. Embedded surfaces keep the page.
--augds-surface-page{color.monochrome.pure-white}Page background.
--augds-surface-page-transparentcolor-mix(in srgb, {surface.page} 0%, transparent)The page colour at zero opacity, the last stop of a fade off the page. Figma binds it by name. A CSS gradient interpolates premultiplied, so it paints the same as transparent. The dark entry repeats the value on purpose, so a dark scope re-declares it.
--augds-surface-sectiontransparentThe plane under a section that tints itself off the page. Transparent in light mode, so the host page shows through the tint as Figma draws it. The page colour in dark mode, so a dark section's text stays readable on a light host page.
--augds-surface-page-sunken{color.neutral-zinc.100}A page background one step below the page, for a region that recedes behind the content around it.
--augds-surface-surface-1{color.monochrome.pure-white}The first raised plane: panels and large containers. Equal to the page in light mode, where a shadow does the separating.
--augds-surface-surface-2{color.monochrome.pure-white}A plane raised above surface-1, for a card inside a panel. Dark mode needs it because a shadow no longer separates two dark planes.
--augds-surface-surface-3{color.monochrome.pure-white}The top raised plane, for a floating element on surface-2. Nothing rises above it, so a shadow separates the next layer in both modes.
--augds-surface-current{surface.page}The plane a floating element paints. The element re-points it to one step above the plane it opened on. The dark entry repeats the value on purpose, so a dark scope re-declares it.
--augds-surface-raised{surface.surface-1}One step above surface/current, for a control or tile that sits on it. A plane re-points both together. The dark entry repeats the value on purpose, so a dark scope re-declares it.
--augds-surface-sunken-1{color.alpha-black.3}A plane recessed one step from whatever sits behind it. Translucent on purpose, so one value holds its separation on the page and on both raised planes.
--augds-surface-sunken-2{color.alpha-black.4}A plane recessed two steps.
--augds-surface-scrim{color.alpha-black.10}Dimmed backdrop behind modals and sheets. Light on purpose: it is paired with a blur, and the blur does the separating. Never use it without the blur.
--augds-surface-scrim-strong{color.alpha-black.30}The backdrop behind a modal dialog or sheet in an app shell. Strong enough that the page reads as paused. It darkens in both modes, so a dark page never lightens behind a dialog.
--augds-surface-elevated{surface.surface-1}Deprecated. Use surface-1.
--augds-surface-half-sunken{surface.sunken-1}Deprecated. Use sunken-1.
--augds-surface-sunken{surface.sunken-2}Deprecated. Use sunken-2.
--augds-surface-sunken-subtle{surface.sunken-1}Deprecated. Use sunken-1.
--augds-foreground-primary{color.neutral-zinc.900}Default text.
--augds-foreground-secondary{color.neutral-zinc.600}Supporting text.
--augds-foreground-tertiary{color.neutral-zinc.500}Captions and metadata.
--augds-foreground-quaternary{color.neutral-zinc.400}Low-emphasis text.
--augds-foreground-quinary{color.neutral-zinc.300}Lowest-emphasis text.
--augds-foreground-disabled{color.neutral-zinc.400}Text in disabled controls.
--augds-foreground-brand{brand-color.primary}The client brand color as supplied. No contrast guarantee.
--augds-foreground-brand-readable{brand-color.primary-readable}Brand-colored text and icons, at a readable step.
--augds-foreground-on-brand{brand-color.on-primary}Text and icons on brand fills.
--augds-foreground-inverse{color.neutral-zinc.50}Text on a plane of the opposite polarity.
--augds-foreground-white-fixed-primary{color.monochrome.pure-white}Text and icons that stay white in both modes, such as a label on a photo or on a fill that does not flip. Use inverse when the plane behind flips with the mode.
--augds-foreground-selected{color.neutral-zinc.900}The label of a selected neutral item, such as the current nav item or segment. Brand stays off navigation on purpose.
--augds-foreground-white-fixed-secondarycolor-mix(in srgb, {color.monochrome.pure-white} 80%, transparent)Secondary text that stays white in both modes, under a white-fixed-primary line.
--augds-foreground-white-fixed{foreground.white-fixed-primary}Deprecated. Use white-fixed-primary.
--augds-border-subtle{color.neutral-zinc.150}Faint dividers.
--augds-border-default{color.neutral-zinc.200}Card edges, panel hairlines, dividers, and the edge of a labelled control. See docs/standards/contrast.md.
--augds-border-strong{color.neutral-zinc.300}Emphasized borders.
--augds-border-input{color.neutral-zinc.200}Form field borders, kept quiet on purpose. Does not clear the 3:1 floor it owes, so a field also reads by its label and its fill. See docs/standards/contrast.md.
--augds-border-solid-neutral{color.neutral-zinc.950}A full-strength neutral edge, for a border that has to read as a deliberate line rather than a divider.
--augds-border-brand{brand-color.primary}Brand-colored borders.
--augds-border-brand-subtle{brand-color.primary-tint-3}Light brand borders on tinted backgrounds.
--augds-border-overlay-ring{color.alpha-black.6}A 1px inner ring on a floating layer, an image or an avatar. It replaces a hard border, so the edge holds on any fill without drawing a line.
--augds-border-transparent-1{color.alpha-black.3}The faintest translucent border, which takes the colour of the surface behind it.
--augds-border-transparent-2{color.alpha-black.4}A translucent border one step stronger than transparent-1.
--augds-border-transparent-3{color.alpha-black.5}The strongest translucent border.
--augds-fill-1{color.alpha-black.4}The default fill for a grouped block, a card or an inspector pane on a panel. The first step of the fill ladder.
--augds-fill-2{color.alpha-black.6}A media tile, a medallion tile, a filled input or a secondary control. One step above fill-1.
--augds-fill-3{color.alpha-black.10}A segmented control track, a pressed tile or an avatar placeholder. The strongest fill.
--augds-fill-selected{color.alpha-black.6}A selected nav item, tab, segment or list row. Neutral on purpose, so brand stays on the primary action.
--augds-background-brand{brand-color.primary}Primary buttons and brand-filled elements.
--augds-background-brand-tint-1{brand-color.primary-tint-1}The quietest tinted brand background.
--augds-background-brand-tint-2{brand-color.primary-tint-2}Tinted brand backgrounds.
--augds-background-brand-subtle{background.brand-tint-2}Deprecated. Use brand-tint-2.
--augds-background-neutral{color.neutral-zinc.950}A full-strength neutral fill.
--augds-background-neutral-subtle{color.neutral-zinc.200}A quiet neutral fill for a secondary control that carries a foreground-primary glyph, such as the cancel and stop buttons beside a recording.
--augds-background-sunken-1{color.alpha-black.4}An element fill recessed one step from whatever sits behind it. Translucent, so one value keeps its separation on every plane.
--augds-background-sunken-2{color.alpha-black.5}An element fill recessed two steps.
--augds-background-inverse{color.monochrome.pure-white}Fills on a plane of the opposite polarity.
--augds-background-floating{color.monochrome.pure-white}A control that floats over content. Opaque white in light mode, and translucent in dark mode, where it lightens whatever sits behind it.
--augds-background-white-fixed{color.monochrome.pure-white}A fill that stays white in both modes, such as a control on a brand header that does not flip. Use inverse when the plane behind flips with the mode.
--augds-background-disabled{color.neutral-zinc.150}Disabled control fills.
--augds-background-sunken{background.sunken-1}Deprecated. Use sunken-1.
--augds-background-half-sunken{background.sunken-1}Deprecated. Use sunken-1.
--augds-status-success-bg{color.green.100}Background for success messages.
--augds-status-success-fg{color.green.700}Text and icons for success messages.
--augds-status-warning-bg{color.amber.100}Background for warning messages.
--augds-status-warning-fg{color.amber.700}Text and icons for warning messages.
--augds-status-error-bg{color.red.100}Background for error messages.
--augds-status-error-fg{color.red.700}Text and icons for error messages.
--augds-status-info-bg{color.sky.100}Background for informational messages.
--augds-status-info-fg{color.sky.700}Text and icons for informational messages.
--augds-status-neutral-bg{color.neutral-zinc.150}Background for a neutral status that carries no outcome.
--augds-status-neutral-fg{color.neutral-zinc.800}Text and icons for a neutral status.
--augds-interaction-hover{color.alpha-black.6}Hover overlay.
--augds-interaction-pressed{color.alpha-black.10}Pressed overlay.
--augds-interaction-hover-light{color.alpha-black.4}Lighter hover overlay for subtle controls.
--augds-interaction-pressed-light{color.alpha-black.6}Lighter pressed overlay for subtle controls.
--augds-interaction-focus-ring{color.neutral-zinc.900}Keyboard focus indicator. Neutral by decision — see docs/brand-theming-rules.md B3.
--augds-chart-categorical-1{color.indigo.700}The first series. It stays apart from every other slot, because a ring wraps its last series round to touch the first.
--augds-chart-categorical-2{color.sky.400}The second series.
--augds-chart-categorical-3{color.teal.600}The third series.
--augds-chart-categorical-4{color.violet.500}The fourth series. One step reads on both pages.
--augds-chart-categorical-5{color.aqua.400}The fifth series.
--augds-chart-categorical-6{color.lavender.300}The sixth series.
--augds-chart-categorical-other{color.neutral-zinc.500}Every series past the last slot. A chart folds them into this one neutral.
--augds-chart-track{color.neutral-zinc.150}The part of a ring or bar that no series claims.
--augds-surface-scrim-blur3pxBackdrop blur behind modals, sheets and in-panel overlays. Figma authors this as a background-blur effect of radius 6 (scrim-blur); a Figma background-blur radius is roughly twice the equivalent CSS backdrop-filter: blur(), and Figma's own CSS export for that effect is 3px. Stored as the CSS value so the components can use it directly.

Brand

The only layer a partner replaces. The ramp is the input; the roles say which rung each job takes.

TokenValueNotes
--augds-brand-primitive-scale-50#f6f4ff
--augds-brand-primitive-scale-100#ede9fe
--augds-brand-primitive-scale-200#dcd2fa
--augds-brand-primitive-scale-300#c6b7f2
--augds-brand-primitive-scale-400#ac98e2
--augds-brand-primitive-scale-500#957dce
--augds-brand-primitive-scale-600#735ca8Holds the base brand colour unmodified.
--augds-brand-primitive-scale-700#675396
--augds-brand-primitive-scale-800#54437a
--augds-brand-primitive-scale-900#463965
--augds-brand-primitive-scale-950#29213e
--augds-brand-color-primary{brand-primitive-scale.600}Brand base color.
--augds-brand-color-primary-readable{brand-primitive-scale.600}The nearest rung to the brand color clearing 4.5:1 against surface/sunken. Brand-colored text and icons.
--augds-brand-color-primary-tint{brand-primitive-scale.900}Deprecated. Nothing reads it, and it has no replacement.
--augds-brand-color-primary-tint-1color-mix(in srgb, transparent, {brand-color.primary} 8%)Quietest brand tint. The brand fill at 8%, and the dark fill at 10%.
--augds-brand-color-primary-tint-2color-mix(in srgb, transparent, {brand-color.primary} 16%)Middle brand tint. The brand fill at 16%.
--augds-brand-color-primary-tint-3color-mix(in srgb, transparent, {brand-color.primary} 30%)Strongest brand tint. Borders on brand-tinted backgrounds. The brand fill at 30%.
--augds-brand-color-primary-tint-subtle{brand-color.primary-tint-2}Deprecated. Use primary-tint-2.
--augds-brand-color-primary-tint-strong{brand-color.primary-tint-3}Deprecated. Use primary-tint-3.
--augds-brand-color-primary-shade{brand-primitive-scale.900}Hover and pressed colour of brand text. The same step for every brand.
--augds-brand-color-on-primary{color.monochrome.pure-white}Text and icons on brand fill.
--augds-brand-color-primary-dark{brand-primitive-scale.600}The brand fill in dark mode. From the fill's own step, the first lighter step that clears 3:1 on the dark page.
--augds-brand-color-primary-readable-dark{brand-primitive-scale.500}Brand-coloured text and icons in dark mode. From the brand's own step, the nearest step that clears 4.5:1 on the dark page.
--augds-brand-color-on-primary-dark{color.monochrome.pure-white}Text and icons on the dark-mode brand fill.

Primitives

Raw ramps. A component never reads one directly.

TokenValueNotes
--augds-color-neutral-zinc-50#fafafa
--augds-color-neutral-zinc-100#f7f7f8
--augds-color-neutral-zinc-150#ececee
--augds-color-neutral-zinc-200#e4e4e7
--augds-color-neutral-zinc-300#d4d4d8
--augds-color-neutral-zinc-400#a1a1aa
--augds-color-neutral-zinc-500#71717a
--augds-color-neutral-zinc-600#52525b
--augds-color-neutral-zinc-700#3f3f46
--augds-color-neutral-zinc-750#333336
--augds-color-neutral-zinc-800#27272a
--augds-color-neutral-zinc-825#232327
--augds-color-neutral-zinc-850#1f1f22
--augds-color-neutral-zinc-900#18181b
--augds-color-neutral-zinc-950#09090b
--augds-color-green-50#f0fdf4
--augds-color-green-100#dcfce7
--augds-color-green-200#bbf7d0
--augds-color-green-300#86efac
--augds-color-green-400#4ade80
--augds-color-green-500#22c55e
--augds-color-green-600#16a34a
--augds-color-green-700#15803d
--augds-color-green-800#166534
--augds-color-green-900#14532d
--augds-color-green-950#052e16
--augds-color-amber-50#fffbeb
--augds-color-amber-100#fef3c7
--augds-color-amber-200#fde68a
--augds-color-amber-300#fcd34d
--augds-color-amber-400#fbbf24
--augds-color-amber-500#f59e0b
--augds-color-amber-600#d97706
--augds-color-amber-700#b45309
--augds-color-amber-800#92400e
--augds-color-amber-900#78350f
--augds-color-amber-950#451a03
--augds-color-red-50#fef2f2
--augds-color-red-100#fee2e2
--augds-color-red-200#fecaca
--augds-color-red-300#fca5a5
--augds-color-red-400#f87171
--augds-color-red-500#ef4444
--augds-color-red-600#dc2626
--augds-color-red-700#b91c1c
--augds-color-red-800#991b1b
--augds-color-red-900#7f1d1d
--augds-color-red-950#450a0a
--augds-color-sky-50#f0f9ff
--augds-color-sky-100#e0f2fe
--augds-color-sky-200#bae6fd
--augds-color-sky-300#7dd3fc
--augds-color-sky-400#38bdf8
--augds-color-sky-500#0ea5e9
--augds-color-sky-600#0284c7
--augds-color-sky-650#00709fA chart step, tuned in OKLCH. It clears 3:1 on the dark page, which sky-700 misses.
--augds-color-sky-700#0369a1
--augds-color-sky-800#075985
--augds-color-sky-900#0c4a6e
--augds-color-sky-950#082f49
--augds-color-indigo-400#5993f2
--augds-color-indigo-700#404eae
--augds-color-teal-500#00a399
--augds-color-teal-600#0d9488
--augds-color-violet-500#9c5fc1
--augds-color-aqua-400#58c5a4
--augds-color-aqua-700#008066
--augds-color-lavender-300#9895e2
--augds-color-lavender-600#5c59bf
--augds-color-monochrome-pure-white#ffffff
--augds-color-monochrome-pure-black#000000
--augds-color-alpha-black-2rgba(24, 24, 27, 0.02)
--augds-color-alpha-black-3rgba(24, 24, 27, 0.03)
--augds-color-alpha-black-4rgba(24, 24, 27, 0.04)
--augds-color-alpha-black-5rgba(24, 24, 27, 0.05)
--augds-color-alpha-black-6rgba(24, 24, 27, 0.06)
--augds-color-alpha-black-8rgba(24, 24, 27, 0.08)
--augds-color-alpha-black-10rgba(24, 24, 27, 0.10)
--augds-color-alpha-black-20rgba(24, 24, 27, 0.20)
--augds-color-alpha-black-30rgba(24, 24, 27, 0.30)
--augds-color-alpha-black-40rgba(24, 24, 27, 0.40)
--augds-color-alpha-black-60rgba(24, 24, 27, 0.60)A label laid over a photograph. Pure white text on it holds 4.5:1 even over a white patch of the image.
--augds-color-alpha-white-2rgba(255, 255, 255, 0.02)
--augds-color-alpha-white-3rgba(255, 255, 255, 0.03)
--augds-color-alpha-white-4rgba(255, 255, 255, 0.04)
--augds-color-alpha-white-5rgba(255, 255, 255, 0.05)
--augds-color-alpha-white-6rgba(255, 255, 255, 0.06)
--augds-color-alpha-white-8rgba(255, 255, 255, 0.08)
--augds-color-alpha-white-10rgba(255, 255, 255, 0.10)
--augds-color-alpha-white-20rgba(255, 255, 255, 0.20)
--augds-color-alpha-white-30rgba(255, 255, 255, 0.30)
--augds-color-alpha-white-40rgba(255, 255, 255, 0.40)
--augds-color-alpha-2{color.alpha-black.2}
--augds-color-alpha-4{color.alpha-black.4}
--augds-color-alpha-6{color.alpha-black.6}
--augds-color-alpha-8{color.alpha-black.8}
--augds-color-alpha-10{color.alpha-black.10}
--augds-color-alpha-20{color.alpha-black.20}
--augds-color-alpha-30{color.alpha-black.30}
--augds-color-alpha-40{color.alpha-black.40}