---
name: baseline-ui
description: Output the project design system reference — colors, typography, spacing, component patterns. Invoke when discussing visual consistency, design tokens, or referencing the style guide.
user-invocable: true
title: baseline-ui
canonical_url: https://skilld.dev/gh/colaberryintern/colaberryenterprise_ai_leadershipaccelerator/baseline-ui
last_updated: 2026-11-16T23:11:39.000Z
---

> Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt)

> **Skill from skilld.dev.** Follow the user's requested action.
> If the user asked to fork this Skill, follow the fork workflow below. Do not execute the Skill instructions while copying it.
> Otherwise, follow the instructions below for this session. You do not need to install anything.
>
> If the user asked to install this Skill, run `npx skilld install colaberryintern/colaberryenterprise_ai_leadershipaccelerator/baseline-ui`. Install writes the Skill files into the project, so every session loads them.
>
> ## Fork workflow
>
> A fork creates an editable local Skill with its original author and licence. The request authorizes copying and local installation.
> 1. Check `./skills/baseline-ui`, the project lockfile, and selected Agent targets together. If the local directory or installed Skill exists, stop. Never overwrite an existing directory or Agent target.
> 2. Read [source metadata](https://skilld.dev/api/v1/skills/colaberryintern/colaberryenterprise_ai_leadershipaccelerator/baseline-ui) once. Use sourceUrl, sourceCommit, skillPath, sourceGone, and license. If the source is gone or its path is missing, stop. If license is null, read licence files at the source commit.
> 3. Fetch only the source commit into a temporary Git repository. Do not clone full history. Derive repository_url from sourceUrl, including repository renames. If sourceCommit is absent, resolve the sourceUrl ref once. Set source_commit to that actual commit. Run these commands in one shell call:
>
> ```sh
> git init --quiet "$temporary_dir"
> git -C "$temporary_dir" fetch --quiet --depth=1 "$repository_url" "$source_commit"
> git -C "$temporary_dir" checkout --quiet --detach FETCH_HEAD
> ```
>
> Read applicable licence declarations and notices at that commit. If copying is not permitted, report the restriction and stop.
> 4. Inspect source entries together, then copy the directory containing skillPath into `./skills/baseline-ui`. Use the user's path if selected. Keep the original SKILL.md, relative links, scripts, binary assets, and executable modes. Exclude .git metadata. Reject symlinks and paths outside the Skill directory. After checking entries, use cp -a where available. A regular source directory needs no custom copy script. Do not save this page wrapper as SKILL.md.
> Preserve author credit, notices, and applicable licence files from repository or parent directories. Add PROVENANCE.md with the Skill page, source URL, actual commit, original path, and licence. Retain any existing PROVENANCE.md and record new provenance separately. Batch source inspection, copying, and provenance work where practical.
> 5. In the project root, run `skilld install ./skills/baseline-ui --mode copy --plain`. If skilld is unavailable, use `npx skilld install ./skills/baseline-ui --mode copy --plain`. This known command needs no help lookup. Install does not support --json. Use detected Agent targets, or add --agent for the targets the user selected. Install the local path, never the upstream selector. If installation fails, preserve the local copy and report the exact failure.
> 6. Confirm the local lockfile source and installed Agent copies once. Report the local path, actual commit, and Agent targets. After edits, reinstall the same local path. Upstream updates must not replace it. Do not publish or push unless the user asks.

# Baseline UI — Design System Reference

When invoked, read and reference these canonical source files before answering any design question:

**There is no single token file. The tokens resolve through a three-layer cascade, and the
LAST layer wins.** Read all three, in this order:

1. `frontend/src/styles/tokens.css` — 101 custom properties on `:root`. Reached via
   `global.css`, which `@import`s it. **Imported at `index.tsx:23`.**
2. `frontend/src/styles/brand-bridge.css` — **redefines 21 of those same properties on
   `:root`, and is imported at `index.tsx:26`, AFTER `global.css`.** Same selector, same
   specificity, later source order, so for those 21 this file is what renders.
3. `frontend/src/colaberry/tokens/*.css` (`colors.css`, `fonts.css`, …) — what layer 2
   points `var()` at, and therefore where the literal value actually lives.

Also: `frontend/src/styles/responsive.css` (breakpoints, accessibility rules) and
`frontend/src/components/Layout/AdminLayout.tsx` (admin shell layout).

---

## Color Palette (CSS Custom Properties)

**Use the RENDERS column.** The `tokens.css` column is what that one file says and is kept
here only so the difference is visible — it is not what the browser paints.

| Token | RENDERS AS | `tokens.css` says | Usage |
|---|---|---|---|
| `--color-primary` | `#FB2832` | `#FB2832` | **Colaberry cherry** — headings and brand. **White text on it is 3.85:1 and FAILS WCAG AA.** Do not use it as a fill behind white text; see the contrast table below |
| `--color-primary-light` | **`#FD5760`** | ~~`#C20E1E`~~ | Links, hover, focus outlines. A light coral, **not** a deep cherry. **White on it is 3.13:1, the worst ratio in the system** |
| `--color-secondary` | **`#E5121D`** | ~~`#e53e3e`~~ | CTAs, warnings, destructive actions |
| `--color-accent` | **`#5BA63C`** | ~~`#38a169`~~ | Green — success states, positive indicators |
| `--color-bg` | `#FFFFFF` | `#ffffff` | Page background |
| `--color-bg-alt` | **`#F8F8F7`** | ~~`#f7fafc`~~ | Alternate section backgrounds |
| `--color-text` | **`#2B2B2B`** | ~~`#2d3748`~~ | Body text. Neutral, **not** blue-tinted slate |
| `--color-text-light` | **`#6B6B6B`** | ~~`#718096`~~ | Muted/secondary text |
| `--color-border` | **`#E4E4E3`** | ~~`#e2e8f0`~~ | Card borders, dividers |
| `--color-muted` | **`#6B6B6B`** | ~~`#9ca3af`~~ | **Identical to `--color-text-light` at runtime** — the two are no longer distinguishable, so do not rely on the contrast between them |

Only `--color-primary` and `--color-bg` survive the cascade unchanged. The other nine are
re-pointed, and the neutrals shift from blue-tinted slate to true grey.

### White text on a brand red — the ratios, because a hex alone is not enough

This table has been wrong twice, and both times the cause was publishing a value with no
evidence attached. A colour can be correctly published and still unusable as a text background.

| Fill | Ratio under white text | Verdict |
|---|---|---|
| `--red-400` `#FD5760` (`--color-primary-light`, the Bootstrap hover) | **3.13:1** | FAILS AA and AA-large |
| `--red-500` `#FB2832` (`--color-primary`, `--action-bg`, what ships) | **3.85:1** | FAILS AA (needs 4.5:1) |
| `--red-600` `#E5121D` (`--color-secondary`, `--action-bg-hover`) | **4.73:1** | Passes |
| `--red-700` `#C20E1E` (`--cherry-deep`, `--action-bg-press`) | **6.22:1** | Passes |

**Both passing values are already in this product**, so an accessible filled button needs no new
colour. Note that red-600 is `#E5121D` in Colaberry's own ramp, **not** Tailwind's `#DC2626`,
which appears nowhere in the brand and would introduce a foreign hue.

Normal-size text needs 4.5:1 (WCAG 1.4.3); the 3:1 allowance is only for 18.66px bold or 24px
normal, which almost no button label in this product reaches. Icons and focus rings need 3:1
(WCAG 1.4.11).

**This is measured, not asserted.** `frontend/src/styles/__tests__/actionContrast.test.ts`
recomputes every one of these from the real stylesheets on each run and holds a pinned inventory
of the surfaces that currently fail, so a new failure breaks the build. The recolour itself
(AF12.6 step 2) is Aleem's and Ali's decision and has not happened — which is why the failing
values above are still what ships.

**Brand palette** (in `tokens.css`, used by the cherry/leaf/berry designs). **These four are
NOT redefined by `brand-bridge.css`**, so unlike the table above, `tokens.css` is the
rendered value here. Note the trap: `--cherry-deep` really is `#C20E1E`, while
`--color-primary-light` — which this file used to label "Cherry deep" — is not:

| Token | Value | Usage |
|---|---|---|
| `--cherry` | `#FB2832` | Same as `--color-primary` |
| `--cherry-deep` | `#C20E1E` | Pressed/active states |
| `--cherry-bg` | `#FFF0F1` | Tinted backgrounds, active nav items |
| `--leaf` | `#77BB4A` | Positive progress bars |

**Rule**: Never hardcode hex values. Always use `var(--color-*)` in CSS or reference Bootstrap utility classes that map to these values.

> **This table has now been wrong twice, and the second time was caused by the fix to the
> first.**
>
> Until 2026-08-25 it listed `--color-primary: #1a365d` (navy) — values that appear nowhere
> in `tokens.css`. The correction told readers to **"verify against `tokens.css` rather than
> trusting this table; a summary can go stale, the source file cannot."**
>
> That advice is the second bug. `tokens.css` is a source file and it *is* stale: nine of
> the ten colours above, and the entire font stack, are overridden at runtime by
> `brand-bridge.css`, which loads three lines later in `index.tsx`. So anyone who followed
> the 2026-08-25 instruction read one real file, correctly, and still got the wrong colour —
> `#C20E1E` where the browser paints `#FD5760`.
>
> **A single source file is not evidence of a rendered value when more than one file defines
> the same property.** Resolve the whole cascade in load order, or read the computed value off
> a real page. Corrected 2026-11-09, from a drift audit Mihret Netsereab ran on
> `product_experience`; her three-layer finding is what exposed it.

---

## Typography

- **Font stack**: `'Roboto', system-ui, -apple-system, 'Segoe UI', sans-serif` —
  `brand-bridge.css:48-49` sets `--font-heading` and `--font-body`, overriding the
  `'Segoe UI'`-first stack in `tokens.css`. **The product renders in Roboto, not Segoe UI.**
  Monospace is `'Roboto Mono', ui-monospace, 'Consolas', 'Monaco', monospace`.
- **Headings**: `font-weight: 700`, `line-height: 1.2`, `color: var(--color-primary)`
- **Body**: `line-height: 1.6`, `color: var(--color-text)`
- **Links**: `color: var(--color-primary-light)`, underline on hover

---

## Spacing & Layout

- **Max width**: `--max-width: 1200px`
- **Section padding**: `4rem 0` (desktop), `2.5rem 0` (mobile), `3rem 0` (tablet)
- **Container**: `max-width: var(--max-width)`, `padding: 0 1rem`
- **Admin shell**: Dark navbar (`navbar-dark bg-dark`), `bg-light` main area, `container py-4` content wrapper

---

## Bootstrap 5 Component Patterns

These are the canonical patterns used throughout the admin UI:

### Cards
```html
<div class="card border-0 shadow-sm mb-4">
  <div class="card-header bg-white fw-semibold">Title</div>
  <div class="card-body">Content</div>
</div>
```

### KPI Stat Cards
```html
<div class="col-md-3">
  <div class="card border-0 shadow-sm">
    <div class="card-body text-center p-3">
      <div class="fs-4 fw-bold text-primary">42</div>
      <div class="text-muted small">Metric Label</div>
    </div>
  </div>
</div>
```

### Data Tables
```html
<div class="table-responsive">
  <table class="table table-hover mb-0">
    <thead class="table-light">...</thead>
    <tbody>...</tbody>
  </table>
</div>
```

### Tab Navigation
```html
<ul class="nav nav-tabs mb-4">
  <li class="nav-item">
    <button class="nav-link active" onClick={...}>Tab Label</button>
  </li>
</ul>
```

### Badges
```html
<span class="badge bg-success">active</span>
<span class="badge bg-warning">paused</span>
<span class="badge bg-info">completed</span>
<span class="badge bg-secondary">draft</span>
<span class="badge bg-danger">TEST MODE</span>
```

### Filter Bars
```html
<div class="d-flex gap-2 mb-3 flex-wrap align-items-center">
  <input class="form-control form-control-sm" style="max-width: 250px" placeholder="Search..." />
  <select class="form-select form-select-sm" style="max-width: 150px">...</select>
  <div class="ms-auto d-flex gap-2">
    <button class="btn btn-outline-primary btn-sm">Action</button>
  </div>
</div>
```

### Buttons

> **A filled `.btn-primary` is 3.85:1 under white text and fails WCAG AA today.** Two independent
> paths paint it: `global.css` sets `.btn-primary { background-color: var(--color-primary)
> !important }`, which beats `brand-bridge.css` regardless of load order, and the vendored design
> system ships its own `.cb-btn` on `var(--action-bg)`. Editing tokens alone changes neither.
> For new work needing a filled action button, use `--color-secondary` (`#E5121D`, 4.73:1) as
> Aleem instructed, until the ramp is corrected upstream.

```html
<button class="btn btn-primary btn-sm">Primary</button>
<button class="btn btn-outline-secondary btn-sm">Secondary</button>
<button class="btn btn-outline-danger btn-sm">Danger</button>
<button class="btn btn-success btn-sm">Success</button>
```

### Form Controls
```html
<label class="form-label small fw-medium">Label</label>
<input class="form-control form-control-sm" />
<div class="form-text">Helper text</div>

<!-- Toggle switch -->
<div class="form-check form-switch">
  <input class="form-check-input" type="checkbox" id="sw-id" />
  <label class="form-check-label small" for="sw-id">
    <span class="fw-medium">Title</span><br />
    <span class="text-muted">Description</span>
  </label>
</div>
```

### Modal Overlays
```html
<div class="modal show d-block" style="backgroundColor: 'rgba(0,0,0,0.5)'">
  <div class="modal-dialog modal-lg">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title">Title</h5>
        <button class="btn-close" onClick={onClose} />
      </div>
      <div class="modal-body" style="max-height: 500px; overflow: auto">...</div>
      <div class="modal-footer">...</div>
    </div>
  </div>
</div>
```

---

## Custom CSS Classes (from global.css)

| Class | Purpose |
|---|---|
| `.card-lift` | Hover: translateY(-4px) + deeper shadow |
| `.fade-in-section` | Scroll-triggered fade + slide-up animation |
| `.badge-label` | Small-caps uppercase label badge |
| `.agent-card` | Bordered card with hover lift for agent/feature cards |
| `.callout-box` | Left-bordered gradient callout for emphasis |
| `.timeline-horizontal` | Horizontal step timeline |
| `.skip-nav` | Skip navigation link for accessibility |
| `.hero-bg` | Hero section with gradient overlay |
| `.btn-accent` | Secondary red CTA button |

---

## Responsive Breakpoints

| Breakpoint | Range | Key adjustments |
|---|---|---|
| Mobile | `< 576px` | Smaller headings, reduced padding, stacked layouts |
| Tablet | `576px – 992px` | Medium headings, intermediate padding |
| Desktop | `> 992px` | Full layout, default spacing |
| Touch targets | `< 992px` | Min 44px height/width on buttons, inputs, links |
| iOS zoom prevention | `< 992px` | `font-size: 16px` on form controls |

---

## Accessibility Patterns

- **Focus**: `outline: 3px solid var(--color-primary-light)`, `outline-offset: 2px` on `:focus-visible`
- **Reduced motion**: All animations/transitions → `0.01ms` when `prefers-reduced-motion: reduce`
- **High contrast**: Cards get `2px solid` borders, `.text-muted` becomes full contrast, outline buttons get `2px` borders

---

## Existing Reusable Components

| Component | Path | Usage |
|---|---|---|
| `TemperatureBadge` | `frontend/src/components/TemperatureBadge.tsx` | Color-coded lead temperature pill (cold/cool/warm/hot/qualified) |
| `LeadDetailModal` | `frontend/src/components/campaign/LeadDetailModal.tsx` | Per-lead drill-down with timeline + temperature history |
| `AdminLayout` | `frontend/src/components/Layout/AdminLayout.tsx` | Admin page shell with dark navbar |
