Skip to content
andres@andresclavijo.comResume (PDF)  (opens in a new tab)LinkedIn  (opens in a new tab)

Design system

The tokens behind this site

One set of role-based tokens, two themes. Every value and contrast ratio here is read from the site’s stylesheet when it builds, so this page can’t drift from what ships.

Tokens
153
Themes
2
Text styles
12
Contrast checks passing
24/24

Foundations

A component never knows which theme it’s in. It asks for a role, and the role resolves per theme.

  1. RolebackgroundWhat it’s for
  2. Token--color-backgroundDeclared once in global.css
  3. Theme value#050505 / #F5F4F0Dark is the default, light overrides
  4. Utilitybg-backgroundWhat a component writes

Visitors get their computer’s setting until they choose. Their choice is saved. Try it here.

Color

Named for the job, not the shade. The theme you’re viewing is marked.

Text

Foregrounds, from strongest to quietest.

TokenUsed forDarkLight
inkHeadings and primary textdark: #F5F4F0light: #111110
mutedBody copydark: #B0B0B0light: #55554F
metaLabels and metadatadark: #8C8C8Clight: #62625C
ghostDimmed display type, large text onlydark: #6E6E6Elight: #7D7D75

Surface

Three steps up from the page.

TokenUsed forDarkLight
backgroundPage backgrounddark: #050505light: #F5F4F0
surfaceCards and panelsdark: #141414light: #FFFFFF
raisedHover and nested surfacesdark: #1D1D1Dlight: #ECEBE5

Border

Structure without weight.

TokenUsed forDarkLight
ruleHairlines and card bordersdark: #262626light: #DAD8D1
muted-2Prose bullet dots, never textdark: #6E6E6Elight: #85857D

Accent

One color, Pantone 2347 U. Each theme takes a step of the scale below.

TokenUsed forDarkLight
accentAction and emphasisdark: #E8644Flight: #BF4633
on-accentText on an accent filldark: #050505light: #FFFFFF

Status

Live and current markers only.

TokenUsed forDarkLight
statusLive and current markersdark: #4FD67Alight: #14783C

Fixed

The same in both themes, for demos that pin a color.

TokenUsed forDarkLight
ink-fixedDark side of the lab swatchesdark: #050505light: #050505
surface-fixedLight side of the lab swatchesdark: #F5F4F0light: #F5F4F0

Accent scale

Generated by Paletta from one seed. #E8644F stays exact at step 500, the hue stays locked, and each theme takes the step closest to the seed that clears AA on its background.

  1. 50#FFEDE8Dark 17.99 passes AALight 1.03
  2. 100#FFD3C9Dark 14.96 passes AALight 1.24
  3. 200#FFB7A8Dark 12.22 passes AALight 1.52
  4. 300#FF9A87Dark 9.92 passes AALight 1.87
  5. 400#F67E69Dark 7.87 passes AALight 2.35
  6. 500#E8644FDark 6.18 passes AALight 3.00Dark accent
  7. 600#BF4633Dark 4.02Light 4.61 passes AALight accent
  8. 700#942B1CDark 2.54Light 7.28 passes AA
  9. 800#69160BDark 1.67Light 11.09 passes AA
  10. 900#400300Dark 1.19Light 15.50 passes AA
  11. 950#1B0000Dark 1.02Light 18.23 passes AA

Typography

One family, Geist. The display, sans and accent tokens all point at it, so a second face is a one-line change.

Text styles

  • Display

    Page titles

    .t-display

    ·

    Product design

  • Display caps

    Case-study titles, the 404

    .t-display-caps

    ·

    Onboarding

  • Title

    Section titles

    .t-title

    ·

    Simplifying Payroll

  • Heading

    Note titles

    .t-heading

    ·

    Eight agents, one product

  • Index

    Work rows, result figures

    .t-index

    ·

    Onboarding

  • Subheading

    Steps, companies, cards

    .t-subheading

    ·

    Discovery

  • Subheading small

    Dense lists

    .t-subheading-sm

    ·

    Design system at Hourly

  • Lead

    The sentence under a title

    .t-lead

    ·

    Pay schedules decide when every employee gets paid.

  • Body

    Long-form text

    .t-body

    ·

    High-stakes financial workflows fail when users can't tell what's about to happen or confirm that it did.

  • Label

    Nav, buttons

    .t-label

    ·

    Let's connect

  • Eyebrow

    Above a title

    .t-eyebrow

    ·

    Selected work

  • Meta

    Keys and captions

    .t-meta

    ·

    Austin, TX

Type scale

  • 3xs0.6875rem11px
  • 2xs0.75rem12px
  • caption0.8125rem13px
  • xs0.875rem14px
  • ui0.9375rem15px
  • sm1rem16px
  • lead1.0625rem17px
  • base1.125rem18px
  • md1.25rem20px
  • brand1.375rem22px
  • lg1.5rem24px
  • xl2rem32px
  • 2xl2.25rem36px

Fluid sizes

  • page-titleInner-page heroes, sized to the heroclamp(3.25rem, 11.4cqi, 11.75rem)
  • finaleThe home page's last lineclamp(3.5rem, 11vw, 12.5rem)
  • stage-floorSelected work, smallest5rem
  • stage-capSelected work, largest18.75rem
  • ghostOutlined word behind the pinned runclamp(7.5rem, 22vw, 23.75rem)
  • numeralThe principle numberclamp(7rem, 17vw, 17rem)
  • numeral-titleThe title under itclamp(1.75rem, 3.2vw, 3.25rem)
  • rowHome's linked rowsclamp(2.5rem, 6.2vw, 6.75rem)
  • case/work and /labs titlesclamp(2.5rem, 5.2vw, 6rem)
  • case-bodyThe summary beside themclamp(1rem, max(min(0.9457rem + 0.232vw, 1.05rem), 0.6rem + 0.5vw), 1.3125rem)
  • productPinned run cardsmin(clamp(3rem, 5.4vw, 5.75rem), 23cqi)
  • story/about's openingclamp(2.5rem, 5vw, 5.25rem)
  • cardWork card titlesclamp(1.5rem, 2.8vw, 3rem)
  • card-indexProject card numberclamp(2.5rem, 8vw, 5rem)
  • card-metaWork card captionsclamp(0.875rem, max(min(0.7717rem + 0.441vw, 0.97rem), 0.7rem + 0.3vw), 1.0625rem)
  • introThe sentence in the home heroclamp(1.125rem, max(min(0.8315rem + 1.252vw, 1.395rem), 1.55vw), 1.5rem)
  • proseCase-study bodyclamp(1.125rem, max(min(0.8533rem + 1.159vw, 1.375rem), 1.53vw), 1.375rem)
  • statStat numbers, sized to their rowclamp(2rem, 7.5cqi, 4.75rem)
  • figure/about's numbersclamp(2.75rem, 4.4vw, 4.25rem)
  • valueValue and hiring statementsclamp(1.5rem, max(min(0.7826rem + 3.061vw, 2.16rem), 2.4vw), 2.25rem)
  • stepTeam and hiring stepsclamp(1.25rem, max(min(0.8478rem + 1.716vw, 1.62rem), 1.8vw), 1.625rem)
  • principlePrinciple titlesclamp(1.375rem, max(min(0.7174rem + 2.806vw, 1.98rem), 2.2vw), 2.125rem)
  • principle-bodyPrinciple textclamp(1.0625rem, max(min(1.0272rem + 0.151vw, 1.095rem), 0.6rem + 0.55vw), 1.375rem)
  • quoteA quote beside a portraitclamp(1.5rem, max(min(0.587rem + 3.896vw, 2.34rem), 2.6vw), 2.5rem)
  • quote-lgA quote with no portraitclamp(1.75rem, 3.6vw, 3.5rem)
  • quote-longA long quoteclamp(1.25rem, max(min(0.6522rem + 2.551vw, 1.8rem), 2vw), 2.125rem)
  • quote-markThe opening quotation markclamp(5rem, 9vw, 9rem)
  • initialsInitials in place of a portraitclamp(4rem, 8vw, 7.5rem)
  • menuPhone menu linksclamp(2rem, min(11vw, 9vh), 5rem)
  • contact-linkContact sheet linksclamp(2.25rem, min(9vh, 13vw), 7rem)

Spacing

A 4px grid: 4px steps to 24, 8px to 64, 16px to 128. The number is the utility’s, so gap-6 in markup and --space-6 in a stylesheet are the same distance.

  • 10.25rem4px
  • 20.5rem8px
  • 30.75rem12px
  • 41rem16px
  • 51.25rem20px
  • 61.5rem24px
  • 82rem32px
  • 102.5rem40px
  • 123rem48px
  • 143.5rem56px
  • 164rem64px
  • 205rem80px
  • 246rem96px
  • 287rem112px
  • 328rem128px

Fluid

Distances that open up with the page, named by their cap.

  • fluid-xsTight gaps and quote textclamp(0.75rem, 2vw, 1.5rem)
  • fluid-smWork card captionsclamp(1.5rem, 2.2vw, 2rem)
  • fluid-mdCard gaps, card insets, the hero topsclamp(1.5rem, 3vw, 3rem)
  • fluid-lgA heading to its block, hero padding, rowsclamp(2rem, 4vw, 4rem)
  • fluid-xlPage columns, /work and /labs entriesclamp(2.5rem, 6vw, 6rem)
  • fluid-2xlBig blocks, above the footerclamp(4rem, 8vw, 7rem)
  • sectionBetween page sectionsclamp(5.5rem, 11vw, 10rem)
  • section-lgHome's closing sectionclamp(7rem, 14vw, 12.5rem)

By screen height

These sit in pinned or full-height views, so they follow the height.

  • screenContact sheet, above the linksclamp(2rem, 8vh, 6rem)
  • cards-rowRows of home's work cardsclamp(6rem, 14vh, 10rem)
  • card-offsetHome's second card starts lowerclamp(10rem, 26vh, 18rem)

Fixed roles

Three values the scale doesn’t cover.

  • summary-labelSits a label on a first line, off the grid on purposeclamp(0.5rem, 1.2vw, 1.15rem)
  • detail-nextAbove the next case, from 1024 up15rem
  • detail-endUnder it11rem

Layout and shape

Content stops growing at the container. Everything inside it keeps a fluid gutter.

  • container-siteWidest the content runs1680px
  • padPage gutter, from phone to desktopclamp(1.25rem, 6vw, 5.5rem)
  • pad-readingGutter on long-form pagesclamp(1.5rem, 8.34vw, 7.5rem)

Radius

  • 2xsSmall copy buttons and chips0.375rem
  • xsFocus rings, tiny marks0.25rem
  • smBadges and inputs0.5rem
  • mdNested media, small panels0.875rem
  • cardCards and stat grids1.125rem
  • frameProduct frames1.5rem
  • panelLarge panels2rem
  • mediaImages, scaling with the pageclamp(1rem, 2.2vw, 2rem)
  • pillButtons999px
  • roundDots and round buttons50%

Sizes and lines

  • tapThe smallest thing to tap or click (44px)2.75rem
  • controlRound buttons: close, menu, arrows3rem
  • control-lgHome's row arrows3.5rem
  • icon-xsThe location pin0.875rem
  • icon-smIcons in small buttons1rem
  • iconIcons in round buttons1.125rem
  • icon-mdArrows1.25rem
  • dot-xsList markers0.375rem
  • dot-smThe live dot0.5rem
  • dotCarousel dots0.625rem
  • mouseThe scroll cue's mouse1.5rem
  • ruleThe hairline between things1px solid var(--color-rule)
  • focus-widthThe focus ring2px

Elevation

Black shadows vanish on dark and turn to grey clouds on light, so the light theme swaps depth for a hairline ring and a short, warm shadow.

  • frameProduct frames at rest
  • frame-liftProduct frames on hover
  • shadowElevation under cardsrgb(0 0 0 / 0.55) / rgb(38 34 26 / 0.14)

Motion

Motion is progressive enhancement: content is visible by default and animates only when JavaScript and the visitor’s motion setting allow it.

  • out-softAlmost everything: fast start, long settlecubic-bezier(0.16, 1, 0.3, 1)
  • in-out-quartWipes that cross the screencubic-bezier(0.76, 0, 0.24, 1)
  • in-softThings leaving, like a page fading outcubic-bezier(0.4, 0, 1, 1)
  • instantPress feedback0.1s
  • quickSmall fades0.2s
  • fastColor and hover0.3s
  • moderateSlides and panels0.45s
  • baseReveals and frames0.6s
  • wipeFull-screen wipes0.7s
  • revealElements rising in on scroll0.7s
  • slowImage scale0.9s
  • slowerLong settles1.6s

Loops

  • bobThe scroll cue, 3 times1.8s
  • pulseThe live dot, 4 times2.4s
  • advanceOne auto-advancing principle or quote6s
  • pingWait before the map pin pings1.5s

Staggers

  • stagger-1Second line of a list arriving0.06s
  • stagger-2A title after its number0.08s
  • stagger-3Third line0.1s
  • stagger-4Everything after that0.14s

Components

These are live: hover them, or tab through to see the focus ring.

Primary.ac-pill .ac-pill-solid
Secondary.ac-pill
Large.ac-pill-lg
Coming soon
Tag.ac-tag
Live
Live tag.ac-tag-live
Draft
Draft marker.ac-draft

Accessibility

Every pair is checked in both themes with the WCAG 2.1 formula. Normal text needs 4.5:1, large text and non-text marks 3:1.

PairUsed forDarkLight
ink on backgroundBody and headings on the page18.52:1AAA17.17:1AAA
muted on backgroundSecondary body copy9.40:1AAA6.82:1AA
meta on backgroundSmall uppercase labels6.06:1AA5.58:1AA
muted-2 on backgroundProse bullet dots, not text4.00:1AA3.38:1AA
ink on surfaceCards and the contact panel16.74:1AAA18.89:1AAA
meta on surfaceContact panel labels5.48:1AA6.14:1AA
accent on backgroundLinks, labels, focus ring6.18:1AA4.61:1AA
accent on surfaceLabels and hover titles on cards5.59:1AA5.07:1AA
on-accent on accentButtons on hover6.18:1AA5.07:1AA
status on backgroundLive and current markers10.90:1AAA5.05:1AA
ghost on backgroundDimmed and outlined display type4.00:1AA3.77:1AA
surface-fixed on ink-fixedSwatch labels in the Paletta lab demo18.52:1AAA18.52:1AAA
  • FocusA 2px accent ring with a 3px offset on everything focusable.
  • Reduced motionAll motion stops under prefers-reduced-motion.
  • Testingaxe runs on every route in both themes, at phone and desktop widths, on every push.