beamix-brand-quality-bar
Beamix billion-dollar-feel design rules: color palette v4.0 (blue #3370FF accent), typography system (InterDisplay + Inter + Fraunces + Geist Mono), spacing, animation budget, and empty-state requirem
SKILL.md.claude/skills/beamix-brand-quality-bar/SKILL.md
GitHubBeamix Brand Quality Bar
Quick reference
Stripe / Linear / Apple / Anthropic-grade. Every space, button, letter intentional. If it would embarrass at YC demo day, it ships at half quality.
When to use
- Before implementing any UI component or page
- Reviewing a design deliverable from product-designer or design-critic
- Checking whether a Framer marketing change or Next.js dashboard update is on-brand
- Settling color, font, or spacing questions without asking Adam
When NOT to use
- For agent-to-agent communication design (this covers user-facing product and marketing surfaces only)
The quality bar
Every pixel, space, button, and letter must be intentional. The reference quality is Stripe/Linear/Apple/Anthropic. Ask: "Would this ship on stripe.com?" If not, it's not done.
Specific failure patterns to eliminate:
- Placeholder color ("I'll fix the blue later")
- Generic shadows (box-shadow: 0 2px 4px rgba(0,0,0,0.1) is not a design decision)
- Inconsistent spacing (pick from the 8pt grid and stay there)
- Mixing font weights without a reason
- Animations that run on every page load without adding meaning
Color palette (v4.0 — locked)
Use these
| Token | Hex | When to use |
|---|---|---|
| Background | #FFFFFF |
Primary page background |
| Surface Alt | #F7F7F7 |
Section backgrounds, alternating panels |
| Primary Text | #0A0A0A |
All headings and body copy |
| Muted Text | #6B7280 |
Descriptions, captions, secondary labels |
| Card Border | #E5E7EB |
Card and input borders |
| Primary Accent | #3370FF |
CTAs, links, logo mark, active states, charts |
| Secondary CTA | #0A0A0A |
Secondary action buttons |
| Warm surface | #F7F6F2 |
Empty states, onboarding, first-run — never grey-on-grey |
Score colors (data viz only — never buttons or links)
| Level | Hex | Range |
|---|---|---|
| Excellent | #06B6D4 |
75–100 |
| Good | #10B981 |
50–74 |
| Fair | #F59E0B |
25–49 |
| Critical | #EF4444 |
0–24 |
Dark mode accent
| Token | Hex |
|---|---|
| Primary Accent (dark) | #5A8FFF |
Retired — do not use
Navy #023C65
Yale Blue #25426A
Blue Slate #536D84
Old orange #F97316
Old indigo #6366F1
Old orange accent #FF3C00
Old background #FAFAF9
Cyan as accent #06B6D4 (score use only — never as CTA or link)
Any PR using these colors is returned BLOCK by design-critic.
Typography
| Font | Use | Do NOT use for |
|---|---|---|
InterDisplay-Medium |
All headings (48–72px), tight tracking -2px | Body copy, UI labels |
Inter |
Body (16–20px), UI labels, captions | Headings |
Fraunces |
Dark sections + testimonial carousel only, white text | Any light-background section |
Geist Mono |
Code blocks, scan data, JSON output | Regular copy |
Type scale
| Level | Size | Weight | Line Height |
|---|---|---|---|
| Hero / Display | 56–72px | InterDisplay-Medium | ~1.05 |
| H1 | ~40px | InterDisplay-Medium | 1.1 |
| H2 | ~28px | Inter 600 | 1.2 |
| H3 | ~20px | Inter 600 | 1.3 |
| Body | ~16px | Inter 400 | 1.6 |
| UI Label / Caption | ~13px | Inter 500 | 1.4 |
| Section Eyebrow | 12px | Inter 600 uppercase | — |
Capitalization: H1 Title Case. H2–H6 Sentence case. Reading width: Body 560px max. Headlines 640px max.
Retired fonts (never use): Montserrat, Outfit, Source Serif, DM Serif, PT Sans, Plus Jakarta Sans, Figtree.
Buttons
| Type | Shape | Background | Text |
|---|---|---|---|
| Primary marketing | Pill (999px radius) | #3370FF |
#FFFFFF |
| Secondary marketing | Pill (999px radius) | #0A0A0A |
#FFFFFF |
| Product utility | Rounded-lg (8px radius) | Context | Context |
Primary and secondary marketing buttons never have a border — fill only.
Spacing system (8pt grid)
4px — icon internal padding, tight inline gaps
8px — component internal padding (card headers, input padding)
16px — standard component padding, row gaps in forms
24px — section internal spacing
32px — between components in a section
48px — between page sections (mobile)
64px — between page sections (desktop)
96px — hero to first section
Deviations from the 8pt grid require an explicit reason in the PR description.
Animation budget
Not every page gets motion. Motion must add meaning.
| Tier | Budget | When to use |
|---|---|---|
| Tier 1 | One signature animation | Hero section, onboarding completion |
| Tier 2 | Subtle transitions only | Page transitions, state changes |
| Tier 3 | No animation | Data tables, dense dashboards |
Animation rules:
- Duration: 200–400ms for UI interactions. 600–1200ms for hero/intro animations.
- Easing:
ease-outfor elements entering.ease-infor elements leaving. - No animation that repeats on every page load without user trigger (except hero — one per session)
- Respect
prefers-reduced-motion— all animations must have a static fallback
Empty states
Every list, table, or data view must have an intentional empty state. No blank white space.
Empty state requirements:
- Illustration or icon (on-brand, not stock)
- Headline: specific to what's missing ("No scans yet" not "No data")
- Action: one clear CTA that resolves the empty state
- Copy: voice canon compliant (no buzzwords, direct, warm)
// Example empty state component
<EmptyState
icon={<ScanIcon />}
headline="No scans yet"
body="Your first GEO scan shows where AI search engines rank your business."
action={<Button variant="primary">Start your first scan</Button>}
/>
See also
design-taste-frontend— [[design-taste-frontend]]high-end-visual-design— [[high-end-visual-design]]minimalist-ui— [[minimalist-ui]]wcag-audit-patterns— [[wcag-audit-patterns]]
Expanded palette — Design Vision 2026-06-05 (DESIGN-VISION.md §3 is authoritative)
The laws here are non-negotiable. When this file and DESIGN-VISION.md disagree on the product, DESIGN-VISION.md wins.
The signature law — blue = you, violet = the agents
The split is not aesthetic preference; it is a product promise baked into the visual language. Every time a user sees the split they learn what Beamix does for them.
| Color | Hex | Role | Hard rule |
|---|---|---|---|
| Blue (accent) | #3370FF |
Your actions: primary CTAs, links, active nav, focus ring, hero metric | The ONLY primary/CTA color. One per surface. |
| Blue tint | #EEF2FF |
Hover fills, tag backgrounds, info badge ground | Never on buttons |
| Blue deep | #2454D6 |
Pressed state, dark-surface CTA | Accent family only |
| Violet (agent) | #6E56F0 |
Agent runs, automations, AI chat, scan-engine diagram, score-reveal gradient | NEVER a button. Not a link. Agent surfaces only. |
| Violet tint | #EEEAFD |
Agent status badge ground, agent card tint | Background/indicator only |
The one sanctioned gradient: #3370FF → #6E56F0 (hero, AI surface, score-reveal only).
Warm off-white surface
--color-surface-warm: #F7F6F2 — use instead of #F7F7F7 when the intent is warmth (empty states, onboarding, first-run). Avoids grey-on-grey-on-grey wash.
Washes — background and illustration fills ONLY
Never on text, buttons, interactive elements, or data visualization.
| Token | Hex | Allowed use |
|---|---|---|
--color-wash-sky |
#EAF0FB |
Hero bg, empty-state illustration fill |
--color-wash-lavender |
#ECE7FB |
Agent/AI section wash |
--color-wash-blush |
#FBEAF0 |
Warm accent moment (testimonial, onboarding) |
--color-wash-mint |
#E6F5EE |
Success / positive moment bg |
Status pill set
Always: tinted ground + saturated text. Never loud fills. Both vars required per pill.
| State | Text token | Background token |
|---|---|---|
| Info | --color-status-info #3370FF |
--color-status-info-bg #EEF2FF |
| Agent | --color-status-agent #6E56F0 |
--color-status-agent-bg #EEEAFD |
| Positive | --color-status-positive #0E9E6E |
--color-status-positive-bg #E6F5EE |
| Warning | --color-status-warning #B8770B |
--color-status-warning-bg #FDF3E0 |
| Critical | --color-status-critical #DC2626 |
--color-status-critical-bg #FDECEC |
| Neutral | --color-status-neutral #6B7280 |
--color-status-neutral-bg #F3F4F6 |
Data-viz series
data-1 #3370FF · data-2 #6E56F0 · data-3 #06B6D4 · data-4 #10B981 · data-5 #F59E0B · data-6 #EF4444 · grid #EAEAEA. Default to the blue/violet pair + desaturated tints. Pastel multi-band, not loud.
Dark panels
--color-panel-dark #14140F · --color-panel-navy #0E1424 — select contrast sections (testimonials, scan-engine diagram, dark hero). Fraunces is allowed here (and only here on the product). Never use a reference's maroon/plum — take the dark-panel move, keep the Beamix palette.
Character — in moments only
Animated character appears only at: empty states · first-run · loading · 404. No persistent companion. See project_beamie_deferred decision.
Motion — minimal, transitions only
ease-out hovers and page transitions everywhere. No choreographed set-pieces. prefers-reduced-motion fallback always required. One exception: the free-scan score-reveal (animated ring + engine ledger) — the acquisition dopamine moment, already shipped. Nothing else in the product animates beyond transitions.
Fraunces — editorial moments only
Dark panels · testimonial carousel · hero display · report covers · score-reveal verdict · the mixed sans+italic-serif headline device. Never in product UI chrome (nav, cards, tables, forms, dashboards).
Anti-patterns
- Using orange, navy, or cyan as accent colors (all retired)
- Using
#3370FFfor data visualization (accent is for actions, not data) - Using Fraunces on light backgrounds (testimonial / dark section only)
- Using violet
#6E56F0on a button or link — ever - Using washes (
#EAF0FBetc.) on text, buttons, or data elements - Generic drop shadows without a specific reason
- Animation on every render without
prefers-reduced-motioncheck - Empty white space where an empty state should be
- Body copy wider than 560px (hurts readability)
- Mixing font weights in a single heading (pick one weight per level)