HUTDB Design System

The tokens, type, surfaces and components every HUTDB page is built from.

The HUTDB design system: logo, colour tokens, typography, surfaces, layout, motion and the shared components behind every page.

The tokens, type, surfaces and components every HUTDB page is built from. Everything here is rendered with the live classes and components, so what you see is what ships.

  1. Principles
  2. Logo
  3. Color
  4. Typography
  5. Surfaces & edges
  6. Layout
  7. Buttons
  8. Forms
  9. Chips & tags
  10. Feedback
  11. Data display
  12. Motion
  13. Icons
  14. Accessibility

01 · Foundations – Principles

HUTDB is a dark, broadcast-style tool for people who live in the menus. Four rules decide most design questions.

Dark ice, one accent at a time

Pages sit on Rink Black with steel-grey chrome. Colour is for meaning: Steel for the main action, Gold for signature features, Success / Danger for outcomes. Never two accents fighting in one control.

Sharp, not soft

Every radius is 0px — rounded-* resolves to square in Tailwind config. Only rounded-full survives, for avatars, dots and status lights.

Edges are light, not lines

A global reset in index.css removes every border, outline and ring. Draw edges with inset box-shadows and separate areas with fill steps (see Surfaces).

Labels shout, copy talks

Small labels, buttons and eyebrows are uppercase with wide tracking. Body copy stays sentence case at comfortable size. Numbers are tabular so columns line up.

03 · Foundations – Color

Brand tokens are exposed as hut-* (e.g. bg-hut-gold, text-hut-ice) and defined once in src/lib/designTokens.js. Each swatch shows the contrast of how it is meant to be used.

Brand tokens

NameTokenHexUseContrast
Rink Blackhut-bg#0A0B0DPage background, text on light fills19.7:1 AAA (White on it)
Boardshut-surface#14161ARaised panels, sidebars, menus18.1:1 AAA (White on it)
Steelhut-primary#B7C4CCPrimary buttons, links, focus, info11.0:1 AAA (On Rink Black)
Icehut-ice#E4EBEFActive and emphasised text, hover on primary16.3:1 AAA (On Rink Black)
Goldhut-gold#C4A35ASignature features, supporters, rewards8.2:1 AAA (On Rink Black)
Successhut-success#5D9B7EConfirmations, gains, valid input6.1:1 AA (On Rink Black)
Dangerhut-danger#C45C6AErrors, destructive actions, losses4.8:1 AA (On Rink Black)
Inkhut-ink#0A0B0DText placed on Steel / Ice / Gold fills11.0:1 AAA (On Steel)

Text on dark

ClassHexUseContrast on Boards
text-white#FFFFFFHeadings, values, primary labels18.1:1 AAA
text-hut-ice#E4EBEFActive nav, links in copy15.0:1 AAA
text-slate-300#CBD5E1Body copy12.2:1 AAA
text-slate-400#94A3B8Secondary copy, captions, idle controls7.1:1 AAA
text-slate-500#7a879bEyebrows and field labels (lifted for contrast)5.0:1 AA
text-slate-600#728097Dimmest allowed text (lifted for contrast)4.5:1 AA

Ratios here are on Boards, the lighter of the two panel colours. slate-500 and text slate-600 are overridden so even the dimmest label passes WCAG AA.

Tint layers

White at low alpha lifts an element off whatever is under it — the arena photo, a panel or a card.

ClassUse
bg-white/[0.03]Quiet zebra rows, empty slots
bg-white/[0.04]Glass, chips at rest
bg-white/[0.06]Ghost hover, selected list row
bg-white/[0.07]Secondary button at rest
bg-white/[0.12]Secondary hover, active chip
bg-black/40Inset wells: inputs, code, stat strips

Status pairs

Tint the background at 10–15%, keep the icon and text at full colour.

04 · Foundations – Typography

Two families. DM Sans does all the work; Space Grotesk is reserved for titles. There is no monospace on the site — font-mono and font-stat resolve to DM Sans.

Typefaces

  • DM Sans (font-sans, body, UI, stats) – 400 · 500 · 600 · 700 — swap, with a metric-matched Arial fallback so text never reflows.
  • Space Grotesk (font-title, headlines only) – Variable 300–700, font-display: block (preloaded) so the hero headline paints once.

Type scale

StyleClassesUseExample
Displayfont-title text-[clamp(2.4rem,7vw,4.5rem)] font-black uppercase leading-[0.9] tracking-tight text-whiteOne per landing page heroPromo Tracker
Page titlefont-title text-3xl font-bold uppercase leading-[0.95] tracking-tight text-white sm:text-5xlPlayer names, profile headersConnor McDavid
Section titlehut-section-titleTool page headings (component class)Market
Block titlefont-title text-2xl font-bold uppercase leading-none tracking-tight text-whiteEmpty states, dialog titles, sectionsNo collections yet
Panel headinghut-panel-headingPanel headers (component class)Line 1 chemistry
Eyebrowtext-[10px] font-bold uppercase tracking-widest text-slate-500Above titles and field labelsSquad Builder
Bodytext-sm leading-relaxed text-slate-300Default copy sizeSearch every card, check community prices and build your squad.
Captiontext-xs text-slate-400Meta, help textUpdated 4 minutes ago
Statfont-stat text-3xl font-black tabular-nums text-whiteRatings, prices, counts94

05 · Foundations – Surfaces & edges

Depth comes from three things: the panel colour, a white tint, and an inset shadow where an edge is needed. Borders do nothing here — the global reset removes them.

Surfaces

  • Panel – Default container for tool content. Classes: bg-[#0c0f13] shadow-[0_24px_60px_-30px_rgba(0,0,0,0.9)]
  • .hut-glass – Frosted chrome over the arena photo. Classes: hut-glass
  • .hut-reading-surface – Opaque, for long-form text over the photo. Classes: hut-reading-surface

Edges

NameClassesUse
Hairline frameshadow-[inset_0_0_0_1px_rgba(255,255,255,0.08)]Panels and cards that need an edge
Dividershadow-[inset_0_-1px_0_0_rgba(255,255,255,0.06)]Header / row separators
Accent frameshadow-[inset_0_0_0_1px_rgba(183,196,204,0.5)]Selected card, current slot
Gold frameshadow-[inset_0_0_0_1px_rgba(196,163,90,0.55)]Signature / supporter elements
Dropshadow-[0_24px_60px_-30px_rgba(0,0,0,0.9)]Floating panels over the arena photo
Focus haloshadow-[0_0_0_2px_rgba(183,196,204,0.35)]Text fields on focus

06 · Foundations – Layout

Phone-first. Tailwind's md, lg and xl all sit at 1024px, so there is one real desktop line, plus phone: and tablet: variants for the app shell at 768px.

Breakpoints

VariantWidthNotes
phone:< 768pxBottom tab bar, compact app bar. Custom variant.
tablet:≥ 768pxClassic header, no tab bar. Custom variant.
sm:≥ 640pxTailwind default.
md: / lg: / xl:≥ 1024pxAll three are 1024px: the single "desktop" line. Prefer md:.
2xl:≥ 1536pxWide desktop.

Page containers

ClassMaxUsed for
max-w-4xl896pxReading pages: About, legal, blog posts
max-w-6xl1152pxTool pages: Watchlist, Collections, Profile
max-w-[1400px]1400pxDense workspaces: Card Extractor, Supporter
max-w-[1600px]1600pxFull-width data: Market, Player DB

Centre with mx-auto w-full and gutter with px-4 sm:px-6.

Shell variables

VariableMeaning
--hut-appbar-hPhone / tablet top bar height
--hut-tabbar-hPhone bottom tab bar (0 elsewhere)
--hut-bottom-chromeEverything fixed at the bottom incl. safe area
--hut-mobile-modal-topWhere sheets start on phones
--hut-nav-offset-desktopContent offset under the desktop header

Anything fixed or sticky offsets itself with these instead of magic numbers.

Spacing rhythm

Tailwind's 4px scale. These steps cover nearly every gap on the site. 1 = 4px, 2 = 8px, 3 = 12px, 4 = 16px, 5 = 20px, 6 = 24px, 8 = 32px, 10 = 40px.

07 · Components – Buttons

Uppercase, wide-tracked, square. Compact buttons are 40px tall on phones and 36px on desktop; large CTAs keep a 48px touch target on phones.

  • Compact buttons – Default in tools, toolbars and dialog footers. One primary per view. (source: components/ui/HutModal.jsx → modalBtn)
  • Disabled & busy – Disabled drops to a quiet fill. While working, keep the label and say what is happening. (source: components/ui/HutModal.jsx → modalBtn)
  • Large CTA – Hero and empty-state calls to action. Full width on phones. (source: index.css → .hut-btn-primary / .hut-btn-secondary)
  • Feature & icon buttons – Gold sheen marks signature features (picture import, auto build) — use sparingly. Icon-only buttons need an aria-label. (source: index.css → .feature-btn, .feature-tag · collections/collectionsUi.js)

08 · Components – Forms

Fields are dark wells (bg-black/30) with no edge until focus, when a soft steel halo appears. Labels are eyebrows. On phones text is at least 16px so iOS never zooms.

  • Text field (source: components/collections/collectionsUi.js → INPUT)
  • Select – Native select for reliability on phones; custom chevron, 48px tall on phones. (source: components/Common.jsx → HudSelect)

09 · Components – Chips, tabs & tags

Chips toggle filters (aria-pressed). Tabs switch views. Tags label things and are never clickable.

  • Filter chips – Toggle — try them. (source: components/Common.jsx → FilterChip)
  • Nav links / tabs – Active item gets aria-current and a lifted fill. (source: components/Common.jsx → NavLink)
  • Tags – Solid tags for headline status; tinted for metadata.

10 · Components – Feedback

Toasts confirm or warn without blocking. Tooltips explain. Dialogs ask. All three portal to <body> so nothing clips them.

  • Toast – Top right, under the header. Auto-hides with a timer bar. (source: components/Toast.jsx)
  • Tooltip – Hover or focus. Flips to stay on screen. (source: components/Tooltip.jsx)
  • Dialog – Sheet on phones, centred window on desktop. Esc and back close it. (source: components/ui/HutModal.jsx)

11 · Components – Data display

Numbers are the product. Make them big, tabular and white; put the label above in an eyebrow. Gains are Success, losses Danger, flat stays grey.

  • Stat block (source: pattern · pages/PromoTracker.jsx → Stat)
  • Table rows – Dividers are inset shadows; numbers right-aligned and tabular.

12 · Foundations – Motion

Quick and purposeful: things arrive with a short ease-out rise and leave instantly. Every animation stops under prefers-reduced-motion.

Class / nameTimingUse
transition150ms easeColour / background changes on hover. The default.
active:scale-[0.98]instantPress feedback on buttons and chips.
hut-page-enter220ms cubic-bezier(0.22,1,0.36,1)Route content rises 8px and fades in.
chem-modal-in260ms cubic-bezier(0.22,1,0.36,1)Dialogs rise 16px and scale from 98.5%.
animate-in fade-in slide-in-from-right-4200msToasts enter from the right.
feature-btn sheen4.5s loopSlow light band on signature buttons.
  • Enter, replayed – hut-page-enter and chem-modal-in side by side.

13 · Foundations – Icons

lucide-react line icons at the default 2px stroke. 16px (h-4 w-4) inside buttons and text, 14px in chips and tags, 20px for standalone controls. Decorative icons get aria-hidden.

Shown: Search, Filter, Star, Heart, Bell, Users, Layers, TrendingUp, Trophy, Coins, Sparkles, Wand2, Flame, Shield, Zap, Plus, Check, X, ChevronDown, ArrowRight, Trash2, Info.

14 · Foundations – Accessibility

Non-negotiables that the shared components already handle — keep them when building something new.

Contrast ≥ 4.5:1 for text

Use the text steps in Color. Never put copy in a colour that is not on that list, and never below slate-600.

Visible keyboard focus

index.css draws a 2px ice outline on :focus-visible for every interactive element. Only replace it with a focus shadow of your own — never remove it. Tab through this page to see it.

Touch targets

48px minimum on phones (40px for dense toolbars), 36px on desktop. Chips and icon buttons included.

Names that match what you see

aria-label only when the visible text is missing or differs, and it starts with the visible words so voice control works. Toggles use aria-pressed, the current tab aria-current.

Respect reduced motion

Wrap any new keyframe in a prefers-reduced-motion: reduce override that stops it.

No zoom on input

Add hut-input-touch to text fields so they are 16px on phones and iOS does not zoom in.