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.
| Token | Value | Notes |
|---|---|---|
--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-track | transparent | The 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-transparent | color-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-section | transparent | The 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-secondary | color-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-blur | 3px | Backdrop 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.
| Token | Value | Notes |
|---|---|---|
--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 | #735ca8 | Holds 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-1 | color-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-2 | color-mix(in srgb, transparent, {brand-color.primary} 16%) | Middle brand tint. The brand fill at 16%. |
--augds-brand-color-primary-tint-3 | color-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.
| Token | Value | Notes |
|---|---|---|
--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 | #00709f | A 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-2 | rgba(24, 24, 27, 0.02) | |
--augds-color-alpha-black-3 | rgba(24, 24, 27, 0.03) | |
--augds-color-alpha-black-4 | rgba(24, 24, 27, 0.04) | |
--augds-color-alpha-black-5 | rgba(24, 24, 27, 0.05) | |
--augds-color-alpha-black-6 | rgba(24, 24, 27, 0.06) | |
--augds-color-alpha-black-8 | rgba(24, 24, 27, 0.08) | |
--augds-color-alpha-black-10 | rgba(24, 24, 27, 0.10) | |
--augds-color-alpha-black-20 | rgba(24, 24, 27, 0.20) | |
--augds-color-alpha-black-30 | rgba(24, 24, 27, 0.30) | |
--augds-color-alpha-black-40 | rgba(24, 24, 27, 0.40) | |
--augds-color-alpha-black-60 | rgba(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-2 | rgba(255, 255, 255, 0.02) | |
--augds-color-alpha-white-3 | rgba(255, 255, 255, 0.03) | |
--augds-color-alpha-white-4 | rgba(255, 255, 255, 0.04) | |
--augds-color-alpha-white-5 | rgba(255, 255, 255, 0.05) | |
--augds-color-alpha-white-6 | rgba(255, 255, 255, 0.06) | |
--augds-color-alpha-white-8 | rgba(255, 255, 255, 0.08) | |
--augds-color-alpha-white-10 | rgba(255, 255, 255, 0.10) | |
--augds-color-alpha-white-20 | rgba(255, 255, 255, 0.20) | |
--augds-color-alpha-white-30 | rgba(255, 255, 255, 0.30) | |
--augds-color-alpha-white-40 | rgba(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} |