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.
HUTDB is a dark, broadcast-style tool for people who live in the menus. Four rules decide most design questions.
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.
Every radius is 0px — rounded-* resolves to square in Tailwind config. Only rounded-full survives, for avatars, dots and status lights.
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).
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.
Two marks: the HUTDB.app wordmark, a white-outlined sticker with a navy 3D extrusion, and the HD.app app icon for square and small spaces. Both are artwork — use the files, never rebuild them in type.
Use it wherever the brand is introduced: header, footer, share images, launch material. alt="HUTDB".
Keep a quarter of the logo's height free on every side (the cyan guide). Nothing else enters that box.
24px tall / 80px wide on screen. Below that, switch to the HD.app icon.
| File | Pixels | Weight | Use |
|---|---|---|---|
| /hutdb-logo-240.webp | 240 × 74 | 9 KB | Navbar (h-7 → h-[34px]). Default for UI up to ~40px tall. |
| /hutdb-logo-400.png | 400 × 124 | 24 KB | Footer, mobile drawer, staff panels, OG images. |
| /hutdb-logo.png | 1024 × 317 | 249 KB | Squad share images, pack reveal, print and press. |
Pick the smallest file that covers the displayed size at 2× — in the navbar the 240px WebP is sharp up to 37px tall. Always pass width and height so the header doesn't shift while it loads.
The square mark for home screens, tabs, notifications and avatars, shown scaled down. The tile has rounded corners baked in, except the maskable version, which fills the square so Android and PWAs can crop it to any shape — keep everything important inside the dashed safe zone (the middle 80%).
| File | Pixels | Name | Use |
|---|---|---|---|
| /android-chrome-512x512.png | 512 × 512 | Android / PWA | site.webmanifest, blog JSON-LD publisher logo |
| /android-chrome-maskable-512x512.png | 512 × 512 | Maskable | PWA icon the OS crops to its own shape |
| /android-chrome-192x192.png | 192 × 192 | Android 192 | Manifest, push notification icon |
| /apple-touch-icon.png | 180 × 180 | Apple touch | iOS home screen; in-app prompts |
| /favicon-192.png | 192 × 192 | Favicon 192 | High-DPI tabs; also the blog desk avatar |
| /favicon-96.png | 96 × 96 | Favicon 96 | Browser tab |
| /favicon-64.png | 64 × 64 | Favicon 64 | Browser tab |
| /favicon-48.png | 48 × 48 | Favicon 48 | Browser tab |
Also shipped: /favicon.ico for old browsers. After changing any icon, bump the ?v= query in index.html and site.webmanifest so browsers refetch it.
public/notification-badge.png · used by public/sw.js)Sampled from the artwork, for launch graphics, merch and partner material that sit next to the logo. They are not UI colours — interface chrome stays on the hut-* palette.
| Name | Hex | Use |
|---|---|---|
| Logo White | #FFFFFF | "HUT", the sticker outline |
| Logo Cyan | #3FB2C2 | "DB.app" in the wordmark |
| Logo Navy | #08203F | Outline and 3D extrusion |
| Icon Cyan | #28E3F4 | "D.app" on the app icon (brighter, for small sizes) |
| Icon Tile | #001942 | App icon background |
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.
| Name | Token | Hex | Use | Contrast |
|---|---|---|---|---|
| Rink Black | hut-bg | #0A0B0D | Page background, text on light fills | 19.7:1 AAA (White on it) |
| Boards | hut-surface | #14161A | Raised panels, sidebars, menus | 18.1:1 AAA (White on it) |
| Steel | hut-primary | #B7C4CC | Primary buttons, links, focus, info | 11.0:1 AAA (On Rink Black) |
| Ice | hut-ice | #E4EBEF | Active and emphasised text, hover on primary | 16.3:1 AAA (On Rink Black) |
| Gold | hut-gold | #C4A35A | Signature features, supporters, rewards | 8.2:1 AAA (On Rink Black) |
| Success | hut-success | #5D9B7E | Confirmations, gains, valid input | 6.1:1 AA (On Rink Black) |
| Danger | hut-danger | #C45C6A | Errors, destructive actions, losses | 4.8:1 AA (On Rink Black) |
| Ink | hut-ink | #0A0B0D | Text placed on Steel / Ice / Gold fills | 11.0:1 AAA (On Steel) |
| Class | Hex | Use | Contrast on Boards |
|---|---|---|---|
text-white | #FFFFFF | Headings, values, primary labels | 18.1:1 AAA |
text-hut-ice | #E4EBEF | Active nav, links in copy | 15.0:1 AAA |
text-slate-300 | #CBD5E1 | Body copy | 12.2:1 AAA |
text-slate-400 | #94A3B8 | Secondary copy, captions, idle controls | 7.1:1 AAA |
text-slate-500 | #7a879b | Eyebrows and field labels (lifted for contrast) | 5.0:1 AA |
text-slate-600 | #728097 | Dimmest 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.
White at low alpha lifts an element off whatever is under it — the arena photo, a panel or a card.
| Class | Use |
|---|---|
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/40 | Inset wells: inputs, code, stat strips |
Tint the background at 10–15%, keep the icon and text at full colour.
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.
font-sans, body, UI, stats) – 400 · 500 · 600 · 700 — swap, with a metric-matched Arial fallback so text never reflows.font-title, headlines only) – Variable 300–700, font-display: block (preloaded) so the hero headline paints once.| Style | Classes | Use | Example |
|---|---|---|---|
| Display | font-title text-[clamp(2.4rem,7vw,4.5rem)] font-black uppercase leading-[0.9] tracking-tight text-white | One per landing page hero | Promo Tracker |
| Page title | font-title text-3xl font-bold uppercase leading-[0.95] tracking-tight text-white sm:text-5xl | Player names, profile headers | Connor McDavid |
| Section title | hut-section-title | Tool page headings (component class) | Market |
| Block title | font-title text-2xl font-bold uppercase leading-none tracking-tight text-white | Empty states, dialog titles, sections | No collections yet |
| Panel heading | hut-panel-heading | Panel headers (component class) | Line 1 chemistry |
| Eyebrow | text-[10px] font-bold uppercase tracking-widest text-slate-500 | Above titles and field labels | Squad Builder |
| Body | text-sm leading-relaxed text-slate-300 | Default copy size | Search every card, check community prices and build your squad. |
| Caption | text-xs text-slate-400 | Meta, help text | Updated 4 minutes ago |
| Stat | font-stat text-3xl font-black tabular-nums text-white | Ratings, prices, counts | 94 |
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.
bg-[#0c0f13] shadow-[0_24px_60px_-30px_rgba(0,0,0,0.9)]hut-glasshut-reading-surface| Name | Classes | Use |
|---|---|---|
| Hairline frame | shadow-[inset_0_0_0_1px_rgba(255,255,255,0.08)] | Panels and cards that need an edge |
| Divider | shadow-[inset_0_-1px_0_0_rgba(255,255,255,0.06)] | Header / row separators |
| Accent frame | shadow-[inset_0_0_0_1px_rgba(183,196,204,0.5)] | Selected card, current slot |
| Gold frame | shadow-[inset_0_0_0_1px_rgba(196,163,90,0.55)] | Signature / supporter elements |
| Drop | shadow-[0_24px_60px_-30px_rgba(0,0,0,0.9)] | Floating panels over the arena photo |
| Focus halo | shadow-[0_0_0_2px_rgba(183,196,204,0.35)] | Text fields on focus |
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.
| Variant | Width | Notes |
|---|---|---|
| phone: | < 768px | Bottom tab bar, compact app bar. Custom variant. |
| tablet: | ≥ 768px | Classic header, no tab bar. Custom variant. |
| sm: | ≥ 640px | Tailwind default. |
| md: / lg: / xl: | ≥ 1024px | All three are 1024px: the single "desktop" line. Prefer md:. |
| 2xl: | ≥ 1536px | Wide desktop. |
| Class | Max | Used for |
|---|---|---|
| max-w-4xl | 896px | Reading pages: About, legal, blog posts |
| max-w-6xl | 1152px | Tool pages: Watchlist, Collections, Profile |
| max-w-[1400px] | 1400px | Dense workspaces: Card Extractor, Supporter |
| max-w-[1600px] | 1600px | Full-width data: Market, Player DB |
Centre with mx-auto w-full and gutter with px-4 sm:px-6.
| Variable | Meaning |
|---|---|
| --hut-appbar-h | Phone / tablet top bar height |
| --hut-tabbar-h | Phone bottom tab bar (0 elsewhere) |
| --hut-bottom-chrome | Everything fixed at the bottom incl. safe area |
| --hut-mobile-modal-top | Where sheets start on phones |
| --hut-nav-offset-desktop | Content offset under the desktop header |
Anything fixed or sticky offsets itself with these instead of magic numbers.
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.
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.
components/collections/collectionsUi.js → INPUT)components/Common.jsx → HudSelect)Chips toggle filters (aria-pressed). Tabs switch views. Tags label things and are never clickable.
components/Common.jsx → FilterChip)components/Common.jsx → NavLink)Toasts confirm or warn without blocking. Tooltips explain. Dialogs ask. All three portal to <body> so nothing clips them.
components/Toast.jsx)components/Tooltip.jsx)components/ui/HutModal.jsx)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.
pattern · pages/PromoTracker.jsx → Stat)Quick and purposeful: things arrive with a short ease-out rise and leave instantly. Every animation stops under prefers-reduced-motion.
| Class / name | Timing | Use |
|---|---|---|
| transition | 150ms ease | Colour / background changes on hover. The default. |
| active:scale-[0.98] | instant | Press feedback on buttons and chips. |
| hut-page-enter | 220ms cubic-bezier(0.22,1,0.36,1) | Route content rises 8px and fades in. |
| chem-modal-in | 260ms cubic-bezier(0.22,1,0.36,1) | Dialogs rise 16px and scale from 98.5%. |
| animate-in fade-in slide-in-from-right-4 | 200ms | Toasts enter from the right. |
| feature-btn sheen | 4.5s loop | Slow light band on signature buttons. |
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.
Non-negotiables that the shared components already handle — keep them when building something new.
Use the text steps in Color. Never put copy in a colour that is not on that list, and never below slate-600.
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.
48px minimum on phones (40px for dense toolbars), 36px on desktop. Chips and icon buttons included.
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.
Wrap any new keyframe in a prefers-reduced-motion: reduce override that stops it.
Add hut-input-touch to text fields so they are 16px on phones and iOS does not zoom in.