Design system

Everything this site is built from: tokens, components and the rules for using them. Examples are live, styled by the same CSS as the rest of the site, and tests fail if the dark colors drift from it.

Version 2

Voice

  • Plain, confident and specific. Lead with real outcomes and numbers, name the tools, and keep claims honest.
  • Everything ships in English and Spanish. Product names, job titles and skill tags stay in English in both.
  • No job-availability messaging, and no filler figures.

Color

Dark is the primary theme: it is the website. Light is a reference palette for light grounds; the CV keeps its own print colors. Sea green means action and pass, blue bell means link, and fuchsia is the accent mark. Text on any colored fill is on-color.

Watch the names: the site’s --surface is the token surface-raised, while the token surface is the site’s --bg.

TokenDarkLightSite variableUsage
ink-black#011627#011627--ink-blackCore palette. Deep navy-black: primary text on light grounds, page background in dark theme.
hot-fuchsia#ff3366#ff3366--hot-fuchsiaCore palette. The brand's signal hue: the logo's dot, the rule under section titles, badges and failing tests. Pair with ink-black text (5.2:1); white text on it is only 3.5:1, so avoid it.
light-sea-green#2ec4b6#2ec4b6--sea-greenCore palette. The action and pass color: primary buttons, focus rings, ✓ marks, stat numbers. Pair with ink-black text (8.4:1); never white text (2.2:1).
bright-snow#f6f7f8#f6f7f8--bright-snowCore palette. Off-white: page background in light theme, primary text in dark theme.
blue-bell#20a4f3#20a4f3--blue-bellCore palette. Links; hover state of primary buttons. Pair with ink-black text (6.7:1); white text on it is 2.7:1, avoid.
surface#011627#f6f7f8--bgPage background (the site's --bg).
surface-alt#04203a#eceff2--bg-altAlternating section bands, with a border-top and border-bottom; the ground of the role switch and Inspect toggle.
surface-raised#0a2540#ffffff--surfaceCards, stats and chips' ground (the site's --surface).
surface-sunken#00101e#e4e8ec--sunkenCode blocks in articles.
surface-sunken-bar#031d33#d9dee3--sunken-barThe Inspect mode tooltip's ground.
border#1b3d5f#cfd6dd--borderHairlines: card outlines, section edges, ghost buttons, timeline rail, the hero's dot grid (decorative, not a control boundary).
text#f6f7f8#011627--textBody and heading text on every surface token.
text-muted#a7b4c4#4a5866--mutedSecondary text — leads, meta, labels — on surface, surface-alt and surface-raised (7.3:1 dark, 6.5:1 light).
primary#2ec4b6#2ec4b6--accentPrimary button fill, role switch indicator, focus ring, timeline dots. Text on it is on-color.
primary-text#2ec4b6#0f7d73--accentSea-green used as text: ✓ pass marks, stat numbers, the role line, company names (8.4:1 dark; the light value darkens to 4.7:1).
link#20a4f3#0b6fb0--accent-2Links on surface tokens (6.7:1 dark, 5.0:1 light).
hot#ff3366#ff3366--hotSection-title rule, WIP badge, failing tests, the logo dot. A mark, not body text on light grounds (3.3:1 on bright-snow).
on-color#011627#011627--accent-inkText and icons on primary, blue-bell and hot fills.
chip-bgrgba(32, 164, 243, 0.12)rgba(32, 164, 243, 0.12)--chip-bgDefault chip ground (blue-bell at 12%), over surface-raised or surface-alt.
chip-text#9bd6fa#0b5c8f--chip-textDefault chip label (blue-bell mixed toward white in dark).
chip-test-bgrgba(46, 196, 182, 0.16)rgba(46, 196, 182, 0.16)--chip-test-bgTesting-stack chip ground (sea-green at 16%).
chip-test-text#8cdfd7#0b6b62--chip-test-textTesting-stack chip label.

Contrast

Every allowed text-on-ground pair, computed from the tokens. Each must reach 4.5:1 in both themes. hot is a mark, not text on light grounds (3.3:1 on bright-snow).

Text on groundDarkLight
text / surface17.1:117.1:1
text / surface-raised14.5:118.3:1
text-muted / surface8.7:16.8:1
text-muted / surface-alt7.8:16.3:1
text-muted / surface-raised7.4:17.3:1
primary-text / surface8.5:14.7:1
link / surface6.7:15.0:1
on-color / primary8.5:18.5:1
on-color / blue-bell6.7:16.7:1
on-color / hot5.2:15.2:1
chip-text / chip-bg8.1:16.4:1
chip-test-text / chip-test-bg7.4:15.6:1

Type

Oswald for headings, numbers and small uppercase labels; Nunito for everything you read; JetBrains Mono for code and chips. JetBrains Mono isn’t bundled, so it falls back to the system monospace.

Display

  • Julian Betancourtdisplay-hero · 5.2rem / 1.05 / 600 / 0.01emThe name in the home hero. Fluid: clamp(2.8rem, 6.4vw, 5.2rem).
  • Blogh1 · 3.6rem / 1.15 / 600 / 0.01emPage title on every page but the home. Fluid on the site: clamp(2.2rem, 5vw, 3.6rem).
  • EXPERIENCEh2 · 2.1rem / 1.15 / 600 / 0.04emSection titles, set UPPERCASE with a 3rem × 4px hot rule beneath. Fluid: clamp(1.6rem, 3vw, 2.1rem).
  • Senior QA Automation Engineerh3 · 1.2rem / 1.15 / 500 / 0.01emCard, job and project titles.
  • 99stat-number · 2.2rem / 1.2 / 600Stat tile numbers, in primary-text, at the end of About.
  • Senior QA Automation Engineerheadline · 1.45rem / 1.65 / 400 / 0.01emThe role line, in primary-text: the CV header, and the hero when JavaScript is off.
  • Julian Betancourtbrand-name · 1.15rem / 1.65 / 500 / 0.02emThe name beside the logo in the header.
  • TESTINGeyebrow · 0.8rem / 1.65 / 400 / 0.08emSmall UPPERCASE labels: the hero location, and above chip groups (Development, Testing).
  • QA Leadrole-switch · 1rem / 1.2 / 500 / 0.03emRole switch labels (0.85rem up to 600px wide).
  • ABOUTscroll-cue · 0.75rem / 1 / 400 / 0.1emThe UPPERCASE label of the scroll cue under the hero.

Text

  • Quality you can readlead · 1.15rem / 1.65 / 400Intro paragraph under a section title, in text-muted.
  • Quality you can readprose · 1.05rem / 1.65 / 400Blog article body.
  • Quality you can readbody · 1rem / 1.65 / 400Default running text.
  • Download CVbutton · 1rem / 1.65 / 600Button labels.
  • Experiencenav · 0.95rem / 1.65 / 400Header navigation links, text-muted until hover.
  • Mar 2022 – Present · Bogotámeta · 0.9rem / 1.65 / 400Dates, places, stat labels, footer text — in text-muted.
  • WIPbadge · 0.72rem / 1.65 / 700Pill badges (WIP).

Code

  • page.getByRole('link', { name: 'Download CV' })code-locator · 0.8rem / 1.4 / 400The locator in the Inspect mode tooltip.
  • Playwrightcode-chip · 0.78rem / 1.65 / 400Chip labels (stack, skills, tags).

Spacing

The rem steps the site really uses. Sections size fluidly: clamp(3rem, 7vw, 5rem) top and bottom.

TokenValueUsage
space-10.4remGaps between chips; icon-to-label gaps are 0.5em.
space-20.75remButton rows (.cta-row).
space-31remGrid gaps between cards and stats.
space-41.4remCard padding.
space-53remSpace above a secondary section title (.sub).
container-max1120pxPage container width (the site's --maxw), with a 1.25rem side gutter.
prose-max760pxReading width (.narrow).
dot-pitch28pxSpacing of the hero's dot grid, 1px dots in border.

Radius

  • radius-xs · 4pxFocus-ring corners.
  • radius-sm · 6pxChips; inline code uses 5px.
  • radius-md · 10pxButtons, certification rows, code blocks, the Inspect tooltip.
  • radius-lg · 14pxCards, stat tiles (the site's --radius).
  • radius-full · 999pxBadges, the language switch, the role switch, the Inspect toggle, timeline dots.

Elevation

Depth comes from surface steps and borders. One shadow exists, for the one element that floats.

shadow-float

The Inspect mode tooltip: the one element that floats above the page. Don't put it on cards.

Motion

Motion confirms an action or marks an entrance; it never carries information alone. Under prefers-reduced-motion: reduce all hero animation and transitions stop, and state stays correct because transforms that carry state are not removed.

NameTimingUsed for
hover0.15s easeButton lift (1px), border and color changes
tip0.18s ease-outInspect tooltip entrance
toast0.3s cubic-bezier(0.3, 1.4, 0.5, 1)Toast entrance
switch0.4s cubic-bezier(0.3, 1.3, 0.5, 1)Role switch indicator
underline0.45s cubic-bezier(0.2, 0.7, 0.2, 1)Fuchsia underline on the hero name
swap0.5s cubic-bezier(0.2, 0.7, 0.2, 1)Role panel content, second item delayed 0.1s
rise0.7s cubic-bezier(0.2, 0.7, 0.2, 1)Hero entrance, staggered from 0.05s to 0.5s
loop1.6s, 1.8sThe Inspect LED pulses while on (turn Inspect off to stop it); the scroll cue bobs twice, then rests

Icons

Tabler Icons (MIT), stroke 2, in currentColor, rendered to inline SVG at build time. No emoji as icons. The ✓ and ✗ glyphs are used only as pass and fail marks.

  • download
  • mail
  • brand-github
  • brand-linkedin
  • arrow-up-right
  • chevron-down

Accessibility

  • WCAG 2.1 AA, checked by axe-core on every route, in both languages, on every deploy.
  • Text reaches 4.5:1; focus rings are a solid 3px primary with a 3px offset.
  • Controls are real button and a elements. Icons next to text hide from assistive technology.
  • Buttons and controls are at least 44px tall. Links inside text and lists are exempt.
  • Content revealed on hover also appears on focus or tap, can be dismissed with Esc, and stays open while the pointer is over it.
  • Everything essential works without JavaScript and without motion.
  • Nothing overflows horizontally at 320px wide.

Components

Hero

Hero

The home page opening: centered name, role switch, role panel, calls to action and scroll cue, on a dot grid. Used once, on the home page.

<Hero lang={lang} />
You provide
Language. Roles and copy come from hero in profile.ts.
Tokens
surfaceborderdisplay-heroeyebrowhotdot-pitch
Rules
  • Size it to the viewport minus the header, so the calls to action stay above the fold at 1280×720.
  • Without JavaScript, show the first role as a headline and hide the controls.
  • One primary button only; give the ghost button a surface ground so the dots don’t show through.
Source
src/components/Hero.astro

Role switch

A two-option pill that swaps the role panel below it, with a sea-green indicator under the selected role.

<div class="role-switch" role="group" aria-label="Show role" data-active="engineer">
  <span class="role-switch-indicator" aria-hidden="true"></span>
  <button type="button" aria-pressed="true">Senior QA Automation Engineer</button>
  <button type="button" aria-pressed="false">QA Lead</button>
</div>
You provide
Two short role labels and the panels they control.
Tokens
surface-altborderprimaryon-colortext-mutedrole-switchradius-full
Rules
  • Use real buttons in a named group, with aria-pressed on each.
  • Labels wrap on narrow screens rather than overflow.
  • Move the indicator through data-active, so it stays correct with motion off.
Source
src/components/Hero.astro

Inspect mode

A toggle that outlines hero elements and reveals a Playwright locator, with a Copy button, on hover, focus or tap.

page.getByRole('link', { name: 'Download CV' })
<button class="inspect-toggle" type="button" aria-pressed="true">
  <span class="inspect-led" aria-hidden="true"></span>
  Inspect mode <span aria-hidden="true">· on</span>
</button>
<div class="inspect-tip-box" style="margin-top: 1rem; width: fit-content">
  <code>page.getByRole('link', { name: 'Download CV' })</code>
  <button class="inspect-copy" type="button">Copy</button>
</div>
You provide
A data-locator on each .inspect-target. Locators are built from the displayed strings.
Tokens
surface-sunken-barprimarycode-locatorshadow-floatsurface-raisedradius-full
Rules
  • Every offered locator must find exactly one visible element, in both languages; a test runs each one.
  • Scope text locators to the hero, because the About summary repeats the same words.
  • Add the tooltip to the page only while open, so its text can’t match the locators it offers.
  • Esc closes the tooltip; it stays open while the pointer or focus is on it.
  • Confirm with the toast only after the clipboard call succeeds; otherwise say it failed.
Source
src/components/Hero.astro

Scroll cue

A small labeled link with a bobbing chevron that leads from the hero to About.

<a class="scroll-cue" href="/#about" style="margin: 0">About
  <svg class="icon" width="20" height="20" viewBox="0 0 24 24" aria-hidden="true"><path fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="m6 9l6 6l6-6"/></svg>
</a>
You provide
The label and the target section.
Tokens
text-mutedtextscroll-cue
Rules
  • Use only once, at the end of the hero.
Source
src/components/Hero.astro

Navigation and page frame

Header

Sticky bar with the logo and name, the section navigation and the language switch.

<Base lang={lang}>…</Base>
You provide
Language and page path; the layout builds the links.
Tokens
surfaceborderbrand-namenavtext-muted
Rules
  • The navigation hides under 760px; the language switch stays.
  • Keep the 85% surface ground with a 10px blur.
Source
src/layouts/Base.astro

Language switch

The pill in the header that links to the same page in the other language.

<a class="lang-switch" href="/es/" hreflang="es" lang="es">Español</a>
You provide
The other language’s URL and its name, written in that language.
Tokens
bordertextprimaryradius-full
Rules
  • Set hreflang and lang on the link.
Source
src/layouts/Base.astro

Skip link

The first focusable element on every page; it appears on focus and jumps to the main content.

<a class="skip" href="#main">…</a>
You provide
The translated label.
Tokens
primaryon-color
Rules
  • Never remove it; keep it first in the document.
Source
src/layouts/Base.astro

Footer

Closes every page with the logo, full name and year, the testing note, the design system link and social links.

<Base lang={lang}>…</Base>
You provide
Language; content comes from profile.ts and i18n.ts.
Tokens
bordertext-mutedprimary-textmeta
Rules
  • It carries the full name, including Cuervo.
Source
src/layouts/Base.astro

Social links

The LinkedIn, GitHub and Email links with icons.

<SocialLinks />
You provide
Nothing: URLs come from profile.ts. External links get rel="me noopener".
Tokens
text-mutedprimary-texttexthot
Rules
  • On hover the label turns text and the icon turns hot.
Source
src/components/SocialLinks.astro

Content

Section title

The uppercase Oswald h2 that opens every section, with a short fuchsia rule beneath it.

Experience

<h2>Experience</h2>
You provide
The text, in sentence or title case (CSS uppercases it), and an id for aria-labelledby.
Tokens
h2hottext
Rules
  • One per section; use h3 below it.
  • Don’t recolor the rule per section.
Source
src/styles/global.css

Button

Link-styled calls to action: a solid sea-green primary and an outlined ghost.

<div class="cta-row">
  <a class="btn btn-primary" href="/#contact">Download CV</a>
  <a class="btn btn-ghost" href="/#contact">Get in touch</a>
</div>
You provide
Label, href, optional leading Tabler icon, and download or target as needed.
Tokens
primaryon-colorblue-bellbordertextlinkradius-mdbutton
Rules
  • One primary per group.
  • Group buttons in .cta-row.
  • Never white text on the primary fill.
Source
src/styles/global.css

Card

The raised panel for skill groups and projects. project adds the header and pinned links; data-status="wip" dashes the border.

Coda · LLM evals

In progress

Evaluating a music composition coach.

  • Promptfoo
  • TypeScript
<article class="card project" data-status="wip">
  <header><h3>Coda · LLM evals</h3><span class="badge">In progress</span></header>
  <p>Evaluating a music composition coach.</p>
  <ul class="chips"><li>Promptfoo</li><li>TypeScript</li></ul>
</article>
You provide
Title, content, optional chips and links.
Tokens
surface-raisedborderradius-lgh3text-mutedprimary-textspace-4
Rules
  • No shadow: cards sit flat.
  • Lay out in an auto-fill grid with a 1rem gap.
Source
src/styles/global.css

Collaboration card

A card with a site screenshot on top, then client, description, stacks and links.

collaborations.map((c) => <article class="card collab">…</article>)
You provide
A collaborations entry in profile.ts and a 16:10 screenshot in public/img/collab/.
Tokens
surface-raisedsurface-altbordereyebrowmetachip-test-bg
Rules
  • Show the testing stack only where real tests exist.
  • Link a repository only if it is public.
Source
src/components/Home.astro

Chip

Small monospace tags for stacks, skills and project tags. Plain text, never links or buttons.

  • Astro
  • TypeScript
  • Playwright
  • axe-core
<ul class="chips"><li>Astro</li><li>TypeScript</li></ul>
<ul class="chips chips-test"><li>Playwright</li><li>axe-core</li></ul>
You provide
List items as plain text; add chips-test for the testing stack.
Tokens
chip-bgchip-textchip-test-bgchip-test-textcode-chipradius-smspace-1
Rules
  • With two groups, label each with an eyebrow.
Source
src/styles/global.css

Badge

A small fuchsia pill that flags status, used for work-in-progress projects.

In progress
<span class="badge">In progress</span>
You provide
A one- or two-word label.
Tokens
hoton-colorbadgeradius-full
Rules
  • Status only; use Chip for tags.
Source
src/styles/global.css

Lists and data

Stat

A tile with one large number and a short label, in a row of four at the end of About.

11+years in QA
30%less maintenance with AI
<div class="stats" style="margin-top: 0">
  <div class="stat"><span class="stat-value">11+</span><span class="stat-label">years in QA</span></div>
  <div class="stat"><span class="stat-value">30%</span><span class="stat-label">less maintenance with AI</span></div>
</div>
You provide
A short value and a lower-case label. Values come from profile.stats.
Tokens
surface-raisedborderradius-lgstat-numberprimary-textmetatext-muted
Rules
  • Four across; two across under 700px.
  • Only real, sourced figures.
Source
src/components/Home.astro

Timeline

The work history: a vertical rail with a ringed dot per job, newest first.

  1. Senior QA Automation Engineer · Perficient Latin America

    Sept 2026 – Present · Bogotá

    • UI test automation with Playwright.
<ol class="timeline">
  <li class="job">
    <h3>Senior QA Automation Engineer <span class="at">· Perficient Latin America</span></h3>
    <p class="job-meta">Sept 2026 – Present · Bogotá</p>
    <ul class="job-highlights"><li>UI test automation with Playwright.</li></ul>
  </li>
</ol>
You provide
experience entries in profile.ts.
Tokens
bordersurface-altprimaryprimary-textmetatext-muted
Rules
  • Keep highlights to 2–4 short lines per job.
  • Dates use <time>.
Source
src/components/Home.astro

Certification list

Outlined rows with a certification name on the left and its issuer on the right.

  • ISTQB® Certified Tester – Foundation LeveliSQI
<ul class="certs"><li><strong>ISTQB® Certified Tester – Foundation Level</strong><span>iSQI</span></li></ul>
You provide
certifications entries in profile.ts.
Tokens
borderradius-mdtext-muted
Rules
  • Certifications only; no formal education entries.
Source
src/components/Home.astro

Post list and cards

Blog entries: hairline rows with title and date on the home page, cards on the blog index.

<ul class="post-list"><li><a href="/blog/">Why this site tests itself</a><time>Nov 2026</time></li></ul>
You provide
Posts from the blog content collection.
Tokens
borderlinktext-mutedmeta
Rules
  • Three latest posts on the home page.
  • Dates use <time>.
Source
src/components/BlogIndex.astro

Prose

Article body styles: headings, inline code, code blocks and quotes.

Run it with npx playwright test.

A test that cannot fail proves nothing.
<div class="prose">
  <p>Run it with <code>npx playwright test</code>.</p>
  <blockquote>A test that cannot fail proves nothing.</blockquote>
</div>
You provide
Rendered Markdown inside .prose.
Tokens
prosesurface-raisedsurface-sunkenborderprimarytext-mutedradius-md
Rules
  • Keep the reading width at prose-max.
Source
src/styles/global.css

Brand

Logo

The JB monogram inlined as SVG, so colors follow the theme.

<Logo size="2.1rem" color="var(--bright-snow)" />
You provide
size, color, dot, and label only when it stands alone without visible text.
Tokens
bright-snowhot-fuchsia
Rules
  • Decorative beside text: it hides from assistive technology by default.
  • The dot may hop on hover; the mark never rotates.
Source
src/components/Logo.astro

Icon

A Tabler icon rendered to inline SVG at build time, in currentColor, with no client JavaScript.

<Icon name="download" />
You provide
The Tabler icon name and an optional size.
Tokens
primary-text
Rules
  • Stroke 2 only; no emoji as icons.
  • Always decorative: put the name in visible text.
Source
src/components/Icon.astro

Page patterns

  • Sections alternate between surface and surface-alt bands, each band with a hairline above and below.
  • Pages sit in a 1120px container with a 1.25rem gutter; reading text is limited to 760px.
  • A section opens with a section title, then an optional lead paragraph in text-muted.
  • The brand divider, a logo between fading hairlines, separates About from Experience.
  • Every page has an English and a Spanish version, linked by the language switch and hreflang.

Retired

Terminal. The career test-run panel left the hero in version 2, along with code-terminal. Its surface-sunken-bar, shadow-float and code-bar (now code-locator) moved to the Inspect mode tooltip.