Augeo AI Docs
Augeo Design SystemComponents

Overview

Every component in the library.

AttachmentGrid

Deprecated wrapper that renders one Attachment per file. It keeps existing imports building until the next major removes it.

ChatBubble

Deprecated wrapper around ChatMessage. It keeps existing imports building until the next major removes it.

InChatToast

Deprecated wrapper around Toast with presentation in-chat. It keeps existing imports building until the next major removes it.

ListRow

Deprecated row geometry in four densities. Each density is now its own component, and the next major removes ListRow.

Actions

Loading

Button

The standard action control across Augeo surfaces.

Loading

ExternalLink

A text link that leaves the app, with the trailing arrow that says so and with target and rel guards a caller cannot override.

Loading

FavoriteButton

A heart toggle for saving an item, which renders the effect phase a host handed it.

Loading

IconButton

Square, icon-only tap target across the prominence ladder.

Input Elements

Loading

CategorySelector

Selectable interest card for a multi-select picker, carrying an icon, a label and a short description, drawn as a tile or as a divider row.

Loading

Checkbox

A square box that turns one option on or off inside a form, with a mixed state for a parent whose children are partly on. The caller owns the checked value and the label.

Loading

CheckboxList

Several choices in one bordered box, each a checkbox row, with nested rows for a branch such as a category's subcategories and a capped height for a long list.

Loading

ChipEntry

A one-line entry that adds the member's own chip on Enter or through its Add button, held to a length limit.

Loading

InlineEditField

A borderless single-line field with a confirm button, for editing one value in place inside a list row. It owns the edit protocol and never the value.

Loading

RadioGroup

One choice from a short list, each option a title over an optional description beside a round radio.

Loading

RangeSlider

A two-thumb slider with a typed field for each bound, for a numeric range such as a point range that filters a listing.

Loading

SearchField

The standard search input, controlled only, reporting every keystroke and submitting on Enter.

Loading

Select

Composable single-value dropdown built on @radix-ui/react-select, skinned with Augeo tokens.

Loading

SelectionChip

Pill-shaped toggle input for choosing from a fixed set of short options — currency amounts, delivery methods, filter pills.

Loading

Switch

The binary on/off control for one setting that takes effect immediately. The caller owns the accessible name and the persistence.

Loading

TextField

Single-line and multi-line text entry with the label, the message and the accessibility wiring in one component.

Data Display

Loading

AvatarStack

Overlapping avatars that stand for a group of people. It draws at most `max` circles, and the last one counts whoever is left over.

Loading

ChartFrame

A fully controlled frame around a chart plot, where the consumer owns the plot and every state the frame renders.

Loading

ChatAvatar

Small circular identity marker for chat surfaces, drawn as a brand-filled disc behind a glyph in three sizes.

Loading

OfferCard

One reward offer with its image, labels and savings note, drawn as a vertical card or a horizontal row.

Loading

ProductCard

A redeemable rewards-catalog product or merchant offer, with a favorite heart, a redeem CTA, and a click through to the product detail page. It renders two write phases and owns no read.

Loading

ProductCardImage

The square image area of a product or offer card, which falls back from the photo to the logo on its brand colour, then to a category icon.

Loading

Progress

A thin bar that fills to show how far a count has come toward its target, such as steps done or points tipped against an allowance.

Loading

RecommendedForYou

A titled row of product picks, with a refresh action and the loading and failure treatments for that read.

Loading

Table

Controlled read-only data table with a header, body, per-column alignment and an empty state.

Loading

Tag

Passive pill label that marks a contextual signal on an offer card, where the category sets the icon and the default label.

Loading

UserAvatar

The identity marker for a person, with a photo, an initials fallback, and one accessible name that survives a failed image.

Overlays

Loading

Modal

Centered overlay dialog built on @radix-ui/react-dialog, as a composable set with a token-driven panel, a dimming backdrop and a built-in close.

Loading

Popover

A composable panel that opens from a trigger press, or a mouse hover when asked, built on @radix-ui/react-popover, wearing the Augeo token skin.

Loading

Sheet

Side-anchored overlay panel built on @radix-ui/react-dialog, for a focused secondary flow beside the page that opened it.

Loading

Tooltip

A composable hover or focus hint built on @radix-ui/react-tooltip, wearing the Augeo token skin.

Loading

Loading

HalftoneGenerating

The wait for a generated image, drawn as brand dots breathing inside a shape, which turn into the image in one ripple when it arrives.

Loading

Skeleton

Loading placeholder that draws any wrapped component as bones in its own layout.

Loading

Spinner

A single rotating ring for inline and button-embedded loading of unknown duration.

Loading

TypingDots

Four dots that run the Flow thinking motion in the brand colour, with no identity mark and no surface fill.

Toast & Error Messages

Loading

InteractionNotice

The recovery surface for a resolved interaction state, offering the one affordance its recovery kind names.

Loading

Toast

A status message for a completed action or a recoverable failure, over the page, in document flow, or inside the chat panel. The consumer owns the queue, mount and timer.

Layout & Structure

Loading

ActionRow

The row of buttons at the end of a panel or under a set, aligned to the end or the centre.

Loading

AmbientSurface

A slow brand-coloured mesh that fills a dark celebration stage, drawn on the GPU, with a still gradient when motion or WebGL is unavailable.

Loading

Card

The plain card recipe, a filled panel with rounded corners and no border or shadow, that groups content on a page.

Loading

Carousel

The scroll track a row of cards sits in, with edge fades, a control each way, and a position indicator.

Loading

EmptyState

Neutral placeholder for a list, a search or a view with no content, with one optional recovery action.

Loading

Grid

The responsive grid a set of profile tiles or badges sits in, with an optional Show All action under it.

Loading

IconBadge

The haloed brand-tint pill that heads a full-panel moment, carrying no accessible name of its own.

Loading

InteractionSlot

The eight exits of a read, rendered from a resolved slot state at the declared intent.

Loading

ListGroup

A grouped list on a fill or a hairline. ListGroupRow is its row, with a lead, a title over a line, a trailing value and a chevron, and ListGroupIcon is the 40px tile a row leads with.

Loading

PanelHeader

The stateless heading block a full-panel surface opens with, with a slot beneath for a control the heading governs.

Loading

PanelMoment

The centred full-panel layout a panel takes when it stops being a list and says one thing.

Loading

ScreenTransition

Animates one panel screen replacing another. Forward arrives from the right, back from the left.

Loading

Section

A labelled region that titles a group of settings or cards, with an optional line under the title and an action beside it. GroupLabel is its title on its own.

Loading

SettingsCard

A raised card on a recessed tray, with an optional footer inside the tray but outside the card.

Loading

SettingsItem

One setting in a settings card, with an optional icon, a title over a description and the control that sets it, a switch or a field.

Loading

Stack

A column or a row of components, spaced by one step of the spacing scale.

Chat

Loading

ActivityCard

An invitation card into a short assistant-offered activity, where the whole card is the open affordance.

Loading

Attachment

One pending file in the chat composer. An image draws a thumbnail tile, a document draws a named chip, and both carry a remove control.

Loading

ChatEmptyState

The steady-state welcome for an assistant surface, stacking an avatar, a partner-configurable greeting and a slot of conversation starters.

Loading

ChatHeader

Top bar for an assistant surface, in the five types Figma draws — an identity capsule that morphs into the settings menu, plus close-only, back-and-close and back-only navigation bars.

Loading

ChatInput

The pill-shaped composer for the Augeo AI concierge, whose host owns the text value, the staged attachments and the dropped files.

Loading

ChatLauncher

Floating entry point to the AI chat surface — a circular partner-primary sparkle button with a glossy inner highlight, optionally paired with a dismissible TeaserMessage card stacked above it.

Loading

ChatMessage

One message in the chat surface. The member's message draws a sunken bubble, and the assistant's reply draws plain text with an optional slot and action row.

Loading

MessageActionButton

The 24px transparent icon button every message-level surface draws its quiet controls from.

Loading

MessageActions

The low-emphasis action row under an assistant message, where each action renders only when its callback is supplied.

Loading

MessageFeedback

Inline capture for why a response was the way it was, with optional reason chips and a freeform comment, revealed under either thumb in MessageActions.

Loading

MessageList

The vertical rhythm of a conversation. A wide gap separates two turns, and a tight one holds a turn together.

Loading

SuggestedPromptChip

Single-fire conversation-starter pill for a chat welcome state, distinct from SelectionChip's stateful toggle.

Loading

WelcomeMessage

The assistant's opening greeting for the rewards chat welcome state, with a first-name slot and a no-name fallback.

Chat Surfaces

Loading

ChatFirstRun

The assistant's welcome the first time a member opens it, before onboarding is done.

Loading

ChatHistory

The saved-conversation list, over entries a consumer has already grouped and already filtered.

Loading

ChatHistoryItem

One saved-conversation row in ChatHistory, with a truncating title over a date and one trailing control.

Loading

InterestSelector

One fully controlled step of the personalization quiz, drawn as a card in the chat stream, whose container owns the selection and the write phase.

Loading

KeywordItem

One learned keyword in ShoppingPreferences, as a wrapping label with an optional remove control.

MiniMenu

The floating action menu behind the chat header control and the per-entry actions on a chat-history row.

Loading

PrivacyConsent

The two consent surfaces, ConsentGate before the first conversation and PrivacyConsent in settings with the confirmation that guards withdrawal.

Loading

ShareFeedback

The standalone feedback panel, whose consumer owns the 1 to 5 rating, the category, the comment and the submitted outcome.

Loading

ShoppingPreferences

The two-tab preferences screen for the categories a member turned on and the keywords the assistant learned, fully controlled and saving on change.

Profile

Loading

AchievementBadge

One badge on its own tile, with the art on a sunken square and its name and description under it. A person sees it earned, in progress or locked. An admin switches it on or off.

Loading

AchievementDetailDialog

One badge in full, with where it stands, its facts, the badges beside it and the people who hold it. The art flies in from the tile it opened from.

Loading

AvatarEditButton

The owner's own avatar with a pencil badge, drawn as one button that opens the photo editor.

Loading

AvatarOptions

The owner's photo with Edit and Remove laid over its lower edge, revealed on hover.

Loading

BadgeRevealFlow

A dialog that unwraps a newly earned badge. The member swipes the hidden badge into view, and confetti, the points earned and a giver's note follow.

Loading

CoreValuesCard

What a person is known for, as a lead column and a scrolling row of value cards, read from the same insights as ValueRow.

Loading

MediaShelf

A wrapping row of things somebody chose, such as films, books or artists.

Loading

MilestoneTile

One thing a person has reached, with a glyph beside it.

Loading

ProfileAchievements

A person's awards as a row of badges with Show All, and the detail dialog for the badge a reader opens.

Loading

ProfileEditor

The owner's own profile editor, which autosaves on blur and holds no draft, so the container owns every value and every commit.

Loading

ProfileEditorOwner

The owner's photo button and name, for the ProfileEditor menuHeader slot.

Loading

ProfileHighlights

The profile's counted figures and reached milestones, in one section card.

Loading

ProfileIdentity

The identity header. It says who a person is, from whichever fields the host supplies, and every field but the name is optional.

Loading

ProfileMetaItem

One fact beside a person's name — a role, a team, or a place.

ProfilePhotoCrop

The member's photo picker and the "Adjust your image" dialog it opens. The member positions and zooms the photo in a round crop, and saves a square PNG to the host.

Loading

ProfileSection

The card chrome every THEO Profile section wears, owning the heading, the clamped intro, the action slot, the owner's edit button and the content states.

Loading

ProfileShoutouts

The recognition written about a person, as a carousel with View All, and a colleague's call to give one.

Loading

PromptAnswerList

Admin-set prompts the profile owner answers, with reactions from colleagues.

Loading

Reaction

How colleagues react to something someone wrote, the affordance to add one, and the picker behind it.

Loading

ReviewCard

One thing a colleague wrote about someone, with who wrote it and when.

Loading

ReviewRoster

The shoutouts behind an attribution line, paged one at a time from the line that names who wrote them.

Loading

SectionScrubber

The rail beside a long page, with one link per section and a ruler that tapers toward the section being read.

Loading

SelfExpression

The user-managed half of a profile, with prompts, a media collection and chips behind one switcher.

Loading

ShoutoutCta

The brand-filled invitation to recognise somebody.

ShoutoutDialog

An illustrated dialog for writing one colleague a shoutout, and the confirmation that follows it.

Loading

StatTile

One observed count the host supplies, with an optional route to the section behind it.

Loading

ValueRow

One derived trait, its share of the evidence, and the evidence behind it.

Story Builder

Loading

RecapEntryCard

An invitation to play a recap, as a card on the page or a modal over it, with the host's illustration, a title, one line of copy, a Play button and a close.

Loading

StoryCard

One slide of a Year in Review, whose variant names the slide and whose fields mirror that slide's payload, with each person, value and badge resolved by the host.

StoryPlayer

A full-screen player that shows a recap one card at a time, under a segmented progress bar, with Previous and Next at the card's foot, tap zones, arrow keys, a visible pause and a scroll indicator when a card holds more than fits.

On Hold

Loading

Disclosure

Controlled expand and collapse chrome, with a leading indicator slot the design system does not interpret.

Recognitions

Loading

AchievementProgress

How far one person is toward a badge, as a short bar and the count in the host's words.

Loading

AddressFields

A controlled group of delivery address fields, with a country select limited to where the host ships.

Loading

AllowanceMeter

What is left of a quarterly allowance to give, out of what was granted, with the reset date and an optional action.

Loading

AwardTemplateCard

One award template, with its badge, category and reward. It either picks the template, as a toggle, or opens it, as a plain press.

Loading

ClipOrderList

The organiser's list of received clips, in playing order, as one grouped list with an include switch and a menu on each clip.

Loading

CollectionCard

The invite card for a group moment, such as a retro or a birthday video, with its status, a done count and one action.

Loading

CommentComposer

A filled reply box under a post that grows with its text, with emoji, a GIF, a voice note and a send button.

Loading

CommentItem

One reply to a post, from one author, holding text, a GIF, a voice note, or a mix.

Loading

ContributionCard

One contribution to a group moment, as words, a voice note or a video clip, or a sealed card before the reveal.

Loading

DoneGate

A count of how many people are done, with the reader's own "I'm done" button.

Loading

FeedPost

One public recognition as a post, read as a sentence from the sender to the recipients, with the badge, the message, the values and places for reactions and a thread.

Loading

GifPicker

A search field over a grid of GIFs, with a line crediting the source, shown as a dialog or a bottom sheet.

Loading

LedgerRow

One entry in a points history, with its reason, its date and a signed amount in neutral tones.

Loading

MomentCard

One moment someone received, as a card that shows who sent it, what it is and whether it is still sealed.

Loading

MomentReveal

The sequence that opens a moment, one stage at a time, from the sealed card to the reward and the thank-you, in a framed stage over the page.

Loading

MontagePlayer

Plays a list of video clips and voice notes in order, between title cards, with a caption naming each contributor and any note they wrote.

Loading

PointsAward

A points reward counting up to its amount, followed by the balance it lands in.

Loading

ReactionBar

The reactions under a post, with a labelled default reaction, a chip per emoji, the quick-row picker and a line naming who reacted.

Loading

ReactorsDialog

Who reacted to a post, with an All tab first and one tab per emoji.

Loading

RecipientPicker

Chosen people as removable chips over a search field and its list of matches.

Loading

RewardChoice

A pick-one grid of reward items, with the picked item's size or colour options underneath.

Loading

RewardCode

A reward code in monospace with a copy button, for an item that arrives as a code.

Loading

RuleRow

One automation rule in a list, with its name, status, sentence summary, last run and an on-off switch.

Loading

RuleStep

One numbered step of a rule builder, marked done, action required or locked, that opens in place to show its form.

Loading

RuleSummary

One automation rule read as a sentence, with the trigger, template and timing emphasised and a placeholder for any part still missing.

Loading

TeamRosterGrid

A grid of the people invited to a group moment, with a face, a name and a title each.

Loading

TeamTable

A roster of people with their team, moments this quarter and in total, last moment and balance, where each name opens that person.

Loading

TemplateEditor

The controlled editor for an award template, with its fields on one side and a live summary of what it sends on the other.

Loading

TimelineEntryRow

One entry in a timeline month — a moment, a badge, a milestone, a promotion, an anniversary or a first day — on ListRow's geometry.

Loading

TimelineRail

Year tabs over a rail of months for a look-back timeline. Each month shows its entries as dots, and the selected month's detail sits below.

Loading

TriggerFields

The controlled form for what starts an automation rule, drawing year chips, a day count or a threshold for whichever trigger kind is chosen.

Loading

VideoRecorder

A stage-driven recorder for a short video clip or a voice note, from consent through the countdown and review to the upload.

Loading

VoicePlayer

A recorded voice note as a waveform with play, a clock, a speed control and the transcript beneath.

Loading

VoiceRecorder

Records a short voice note in stages, from asking for the microphone through a live waveform to a review with the transcript, inline or as a bottom sheet.