Overview
The shared visual language and component library for Augeo's loyalty and engagement products. Token-driven, partner-themable, agent-readable.
What this is
The Augeo Design System is the consumer-facing surface for Augeo's loyalty and engagement products — the AI concierge, offer flows, partner demos, the assistant SDK, and the workplace experiences. It ships from @kigo-digital/design-system with an Augeo brand pack and a white-label partner.* slot any customer can rebind.
How it's organized
Foundations — Color, typography, spacing, radius. DTCG primitives at the bottom; Augeo brand and partner-themable semantic aliases on top. Click any swatch or CSS variable to copy.
Components — Augeo atoms, molecules and composed panels. Each comes with live previews, props, accessibility notes, and the full agent contract.
Interaction Events — What a component may emit, how to migrate one, and which ones have adopted the contract. The status table is generated from the interaction audit.
Patterns — Composed page archetypes: chat surfaces, offer rails, redemption funnels.
Getting Started — Install instructions for tokens and components, including GitHub Packages auth and the app-level theme wrapper.
Agent Consumers — Agent-facing usage guidance and the README-frontmatter contract for machine-readable component selection.
Changelog — Versioning, current release state, published artifacts, and upgrade-impact notes.
Where to start
- Designing. Read Foundations → Colors — see how primitives feed Augeo brand and the partner slot.
- Implementing. Getting Started → Components walks the install + brand-scope wrapper end-to-end.
- Re-theming for a partner. Getting Started → Tokens shows the variable override pattern.
- Building an agent. Agent Consumers → Agent Feed explains the README-frontmatter contract that the design-agent in
augeo-ai-serverreads. - Reporting interaction. Interaction Events → Overview is the contract. Component Status is the generated adoption table.