Skip to content
ResumePT

~/design-system

Terminal Noir, piece by piece

Cold surfaces stepped by luminance, one amber accent, editorial serif titles and a monospaced voice for the machine. Everything here comes from the code that serves the site.

Design tokens

The values below are read from src/styles/global.css at build time: what you see here is what the browser paints. No component uses a colour or a measure outside this scale.

Colours

Terminal Noir: cold surfaces separated by luminance steps and a single amber accent. Noir is the default; Paper comes from the system setting or the theme button. Each contrast ratio is measured against the named token, in both themes.

  • Noir
    Paper

    --color-background

    Page ground.

    Noir #0b0b0cPaper #fbfaf7

  • Noir
    Paper

    --color-surface

    Cards and panels (layer 1).

    Noir #121214Paper #f1efea

  • Noir
    Paper

    --color-surface-elevated

    Popovers, dialogs and floating elements (layer 2).

    Noir #18181bPaper #e9e6df

  • Noir
    Paper

    --color-border

    Decorative hairline. Never the only edge of an interactive target.

    Noir #222226Paper #dcd8cf1.24:1 / 1.36:1 on background

  • Noir
    Paper

    --color-border-strong

    Outline of fields, interactive targets and hover.

    Noir #6b6b74Paper #88837a3.73:1 / 3.61:1 on background

  • Noir
    Paper

    --color-selection

    Text selection background.

    Noir #52525bPaper #d6d2c87.03:1 / 11.50:1 on foreground

  • Noir
    Paper

    --color-foreground

    Primary text.

    Noir #f4f4f5Paper #1c1a1717.90:1 / 16.63:1 on background

  • Noir
    Paper

    --color-muted-foreground

    Secondary text and metadata. Nothing darker becomes text.

    Noir #a1a1aaPaper #5e5a537.68:1 / 6.57:1 on background

  • Noir
    Paper

    --color-primary

    Accent: CTA, link, command and focus ring. Never decoration.

    Noir #f5a623Paper #8657009.71:1 / 5.96:1 on background

  • Noir
    Paper

    --color-primary-foreground

    Text on the accent.

    Noir #0b0b0cPaper #fbfaf79.71:1 / 5.96:1 on primary

  • Noir
    Paper

    --color-success

    Available, build passing.

    Noir #34d399Paper #0b765610.23:1 / 5.38:1 on background

  • Noir
    Paper

    --color-whatsapp

    Only the floating WhatsApp button.

    Noir #25d366Paper #075e549.92:1 / 7.35:1 on background

  • Noir
    Paper

    --color-whatsapp-foreground

    Icon on the WhatsApp button.

    Noir #0b0b0cPaper #fbfaf79.92:1 / 7.35:1 on whatsapp

  • Noir
    Paper

    --color-warning

    Caution, archived project.

    Noir #facf9ePaper #8a530013.57:1 / 6.06:1 on background

  • Noir
    Paper

    --color-destructive

    Form error, failure state.

    Noir #ffb7b0Paper #b4231811.85:1 / 6.30:1 on background

Text clears 4.5:1 on background, surface and surface-elevated in both themes. The border fails on purpose: it is a separator, and an outline that must be seen takes border-strong or primary. No information relies on colour alone.

Spacing

Tight groups, generous separation. A value off the scale is the most common reason a site looks unfinished.

  • --spacing-xs0.25rem · 4px
    Between an icon and its label.
  • --spacing-sm0.5rem · 8px
    Inside badges and buttons.
  • --spacing-md1rem · 16px
    Default component padding.
  • --spacing-lg1.5rem · 24px
    Card padding, between close blocks.
  • --spacing-paragraph1.25rem · 20px
    Between Prose paragraphs.
  • --spacing-xl2.5rem · 40px
    Between blocks inside a section.
  • --spacing-2xl4rem · 64px
    Between sections on phones.
  • --spacing-3xl6rem · 96px
    Between sections on desktop.
  • --spacing-hero-top12.5rem · 200px
    Room above the hero text on desktop.
  • --spacing-hero-bottom7.5rem · 120px
    Room below the hero text on desktop.

Radii and borders

A 1px border everywhere; 2px only on the focus ring. No pill buttons.

  • --radius-sm0.25rem · 4pxBadge, technology tag, chip and kbd.
  • --radius-md0.375rem · 6pxButton, field, card.
  • --radius-lg0.5rem · 8pxPanel, code block, terminal window.
  • --radius-full9999pxAvatar and status dot. Never a button.

Elevation and shadows

Depth comes from luminance steps and the hairline, never from a shadow on the page. A modal is level 2 with a dimmed backdrop behind it.

  • Level 0Pagebackground, no border
  • Level 1Card, panelsurface + border hairline
  • Level 2Popover, palettesurface-elevated + border-strong
  • --shadow-glow0 0 24px rgb(245 166 35 / 0.25)Amber halo on the primary button hover. The only glow in the system.
  • --shadow-window0 12px 32px rgb(0 0 0 / 0.45)Only under the stacked windows of the sales hero. The only drop shadow.

Motion

Three durations and one curve. Only transform, opacity and colour animate. With prefers-reduced-motion, movement stops and the state change stays.

--duration-fast
150ms
Hover and colour change.
--duration-base
250ms
Element entrance and reveal.
--duration-slow
500ms
Page transition, block entrance and the menu underline.
--ease-out
cubic-bezier(0, 0, 0.2, 1)
Exponential ease-out for every transition.

Widths and breakpoints

Mobile-first, no horizontal scroll from 320px. Breakpoints at 640, 1024 and 1280px; the horizontal lock is overflow-x: clip, so the sticky header keeps working.

--container-page
80rem · 1280px
Page column, aligned to the frame.
--container-frame
80rem · 1280px
Header and footer.
--container-list
53rem · 848px
Centred column for lists: blog, archive, home lists.
--container-measure
42rem · 672px
Reading measure on the sales pages.
--container-narrow
48rem · 768px
Narrow column on the sales pages.
--container-sheet
64rem · 1024px
The resume sheet.

Components

Own components in Astro, with no UI library and no client island. Each one below is really rendered, with the same props the pages pass.

<Button />

An action. A link with href, a button without it. 44px minimum target and an amber focus ring.

src/components/ui/Button.astro

  • primary: one per fold; the glow halo lights up on hover, the only glow in the system.
  • secondary: surface with border-strong; the outline turns amber on hover.
  • ghost: text only; takes surface-elevated and amber text on hover.
  • arrow adds an arrow that steps forward on hover; disabled lowers the opacity to 60%.

<Card />

Layer 1: a surface bounded by the hairline. The interactive one lifts the hairline to border-strong on hover, with no shadow.

src/components/ui/Card.astro

Default

A static surface that groups content.

Interactive

Hover it: the hairline lifts to border-strong.

  • window adds the stacked-window shadow, only in the sales hero.
  • A card inside a card does not exist.

<TerminalWindow />

Layer 2: a window recessed into the ground, with a title bar and an actions slot. It holds the agent brief on the contact page.

src/components/ui/TerminalWindow.astro

AGENTS.md
POST /api/hire
200 "Brief received."

<CodeBlock />

An example endpoint or payload, labelled with its language. Post code blocks come from Shiki with the Terminal Noir theme.

src/components/ui/CodeBlock.astro

bash
curl https://nandomoreira.dev/api/resume.json

<CopyButton />

Copies the text of an element by id. Runs on the SiteControls script; without JavaScript, the text stays selectable.

src/components/ui/CopyButton.astro

https://nandomoreira.dev/api/mcp
  • iconOnly: a 44px square, with the label for screen readers only.
  • compact: 32px high, for toolbars.

<TechBadge />

A technology of a case. The brand icon when one exists, always with the name written out.

src/components/ui/TechBadge.astro

AstroTypeScriptFirebasePython

<StatusDot />

The availability dot, in the header brand and the pills. Its colour follows the status and it pulses only while open; the text beside it states the status.

src/components/ui/StatusDot.astro

Available for new projectsLimited availabilityUnavailable right now

<StatItem />

A career number. It throws without a label and a context: a bare number misleads.

src/components/ui/StatItem.astro

30 minto prepare a data batchIt took about five days, in the real estate financing pipeline I ran at Liquid AI.

<Alert />

Confirmation after an action, such as sending the form. The title says what happened; colour never carries it alone.

src/components/ui/Alert.astro

Message sent.I will reply to the e-mail address you gave.

<EmptyState />

A list with no items, or an action with nothing to show. Icon, title and the next step.

src/components/ui/EmptyState.astro

Check your inbox

I sent a confirmation link. The subscription only counts after the click.

<SectionHeader />

A section title. Mono with a hairline by default; accent for the home; step numbers it when order matters.

src/components/ui/SectionHeader.astro

Default

Mono, uppercase, with the decorative hairline below.

Accent

Numbered

<SectionRule />

An edge-to-edge hairline between home sections. Decorative: each section already has its own title.

src/components/ui/SectionRule.astro

<UpdatedAt />

The date strip on pages that change over time: Setup, Now and Privacy.

src/components/ui/UpdatedAt.astro

Updated on .

<Prose />

Long-form body: Inter 18px/1.7, a 68ch measure and Newsreader headings.

src/components/ui/Prose.astro

Why a single layer

Only the access layer calls getCollection. Without that rule, the first page in a hurry reads directly and the surfaces drift apart. See the About page.

  • A test scans src/ and fails a call in the wrong place.
  • The agent answers with the same data the page shows.
A gate that never failed is not a gate.

Icons

(134)

Every icon the site renders, served by astro-icon from the installed Iconify packages. A test fails when an icon is used and missing from this list, or listed and unused. A decorative icon takes aria-hidden; an icon-only control takes aria-label.

Interface (101)

Lucide, outline stroke, 16 to 20px, inheriting the text colour through currentColor. Service icons sit at 20px in a 32px box.

  • lucide:activity
  • lucide:a-large-small
  • lucide:app-window
  • lucide:archive
  • lucide:arrow-down
  • lucide:arrow-right
  • lucide:arrow-up
  • lucide:arrow-up-right
  • lucide:badge-check
  • lucide:ban
  • lucide:bell-off
  • lucide:book-open
  • lucide:bot
  • lucide:calendar-days
  • lucide:chart-no-axes-column-increasing
  • lucide:check
  • lucide:check-circle
  • lucide:chevron-down
  • lucide:circle-check
  • lucide:circle-slash
  • lucide:circle-x
  • lucide:clipboard-check
  • lucide:clipboard-list
  • lucide:clock
  • lucide:cloud-upload
  • lucide:command
  • lucide:copy
  • lucide:credit-card
  • lucide:database
  • lucide:dot
  • lucide:download
  • lucide:external-link
  • lucide:eye
  • lucide:file
  • lucide:file-check
  • lucide:files
  • lucide:file-text
  • lucide:file-warning
  • lucide:flask-conical
  • lucide:gauge
  • lucide:gift
  • lucide:git-commit-horizontal
  • lucide:git-pull-request
  • lucide:globe
  • lucide:hammer
  • lucide:hand
  • lucide:handshake
  • lucide:image
  • lucide:key-round
  • lucide:layers
  • lucide:layout-dashboard
  • lucide:layout-grid
  • lucide:layout-list
  • lucide:layout-template
  • lucide:life-buoy
  • lucide:list
  • lucide:list-checks
  • lucide:lock
  • lucide:lock-keyhole
  • lucide:mail
  • lucide:mail-check
  • lucide:menu
  • lucide:message-circle
  • lucide:messages-square
  • lucide:minus
  • lucide:moon
  • lucide:package
  • lucide:package-check
  • lucide:pause
  • lucide:pencil
  • lucide:play
  • lucide:plug
  • lucide:plus
  • lucide:quote
  • lucide:receipt
  • lucide:receipt-text
  • lucide:rocket
  • lucide:rss
  • lucide:scale
  • lucide:scan-search
  • lucide:search
  • lucide:server
  • lucide:settings
  • lucide:shield-alert
  • lucide:shield-check
  • lucide:shield-off
  • lucide:shirt
  • lucide:shopping-bag
  • lucide:shopping-cart
  • lucide:sparkles
  • lucide:sun
  • lucide:table-of-contents
  • lucide:tag
  • lucide:terminal
  • lucide:trending-up
  • lucide:user
  • lucide:user-round-check
  • lucide:users
  • lucide:workflow
  • lucide:wrench
  • lucide:x

Brands and technologies (33)

Simple Icons, for brands only: networks in the footer and contacts, and the TechBadge technologies. Always next to the name, never alone.

  • simple-icons:astro
  • simple-icons:claude
  • simple-icons:cloudflare
  • simple-icons:cursor
  • simple-icons:docker
  • simple-icons:fastapi
  • simple-icons:firebase
  • simple-icons:github
  • simple-icons:githubactions
  • simple-icons:githubcopilot
  • simple-icons:googlecloud
  • simple-icons:googlegemini
  • simple-icons:googlesearchconsole
  • simple-icons:hono
  • simple-icons:instagram
  • simple-icons:linkedin
  • simple-icons:nextdotjs
  • simple-icons:nodedotjs
  • simple-icons:openai
  • simple-icons:pandas
  • simple-icons:polars
  • simple-icons:postgresql
  • simple-icons:python
  • simple-icons:react
  • simple-icons:replit
  • simple-icons:supabase
  • simple-icons:tailwindcss
  • simple-icons:twitch
  • simple-icons:typescript
  • simple-icons:v0
  • simple-icons:whatsapp
  • simple-icons:x
  • simple-icons:youtube

Typography

Three families, one per job, self-hosted as WOFF2 with font-display: swap and a Latin subset. No request to an external font host.

Families

  • Newsreader--font-serif"Newsreader", Georgia, "Times New Roman", serifWeights 400 to 500, variable, optical size from 24 to 72.Titles. Gives editorial weight to the h1 and the long-form sections.
  • Inter--font-sans"Inter", system-ui, sans-serifWeights 400 to 600, variable.Body and interface. Carries long-form text and all the chrome.
  • JetBrains Mono--font-mono"JetBrains Mono", ui-monospace, monospaceWeights 400 and 500.The machine voice: navigation, dates, technologies, counters and code.

Scale

Each size as the site uses it. Newsreader titles stay at 400 or 500; running text stays between 65 and 75 characters per line; tracking never goes past -0.04em, and only the eyebrow opens to 0.2em.

  • --text-hero4.2rem · 67.2px / 1.05Newsreader

    Software that reaches production

    Hero title of the home and the sales pages.

  • --text-display3rem · 48px / 1.1Newsreader

    Technical decisions, explained

    Inner page h1 from 640px.

  • --text-h12.25rem · 36px / 1.2Newsreader

    A portfolio that agents read

    h1 on phones, post and case titles, the StatItem value.

  • --text-h21.5rem · 24px / 1.3Newsreader

    Why Astro in server mode

    Long-form section (Prose).

  • --text-h31.25rem · 20px / 1.4Inter

    One source of truth

    Subsection, card title, PageHeader lead.

  • --text-lead1.2rem · 19.2px / 1.65Inter

    I build the product, the data pipeline and the engineering standard that make AI deliver results.

    Opening paragraph under a hero title.

  • --text-prose1.125rem · 18px / 1.7Inter

    Long-form body is sans, 18px with a 1.7 line height: on the dark ground, it read better than the serif.

    Post and case body, always inside Prose, with a 68ch measure.

  • --text-body1rem · 16px / 1.625Inter

    Every case needs at least one verifiable link.

    Interface text, summaries and button labels.

  • --text-small0.875rem · 14px / 1.5Inter

    Updated with the latest production build.

    Metadata and captions.

  • --text-caption0.8125rem · 13px / 1.5Inter

    Available for projects

    Compact label on phones: the hero pill, the TechBadge.

  • --text-mono0.875rem · 14px / 1.6JetBrains Mono

    POST /api/hire 200 OK

    Navigation, dates, endpoints and code blocks.

  • --text-micro0.6875rem · 11px / 1.4JetBrains Mono

    Astro · Firebase · MCP

    Row markers and table labels, always uppercase.

  • --text-code-inline0.875emJetBrains Mono

    Only the access layer calls getCollection.

    Inline code: 0.875em, follows the size of the text around it.

Ready to share.

Let’s talk about your project?

The person answering is the person building it. Tell me what you need and I will explain the simplest path.

I prefer to talk on WhatsApp
or