~/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.
- NoirPaper
--color-background
Page ground.
Noir #0b0b0cPaper #fbfaf7
- NoirPaper
--color-surface
Cards and panels (layer 1).
Noir #121214Paper #f1efea
- NoirPaper
--color-surface-elevated
Popovers, dialogs and floating elements (layer 2).
Noir #18181bPaper #e9e6df
- NoirPaper
--color-border
Decorative hairline. Never the only edge of an interactive target.
Noir #222226Paper #dcd8cf1.24:1 / 1.36:1 on background
- NoirPaper
--color-border-strong
Outline of fields, interactive targets and hover.
Noir #6b6b74Paper #88837a3.73:1 / 3.61:1 on background
- NoirPaper
--color-selection
Text selection background.
Noir #52525bPaper #d6d2c87.03:1 / 11.50:1 on foreground
- NoirPaper
--color-foreground
Primary text.
Noir #f4f4f5Paper #1c1a1717.90:1 / 16.63:1 on background
- NoirPaper
--color-muted-foreground
Secondary text and metadata. Nothing darker becomes text.
Noir #a1a1aaPaper #5e5a537.68:1 / 6.57:1 on background
- NoirPaper
--color-primary
Accent: CTA, link, command and focus ring. Never decoration.
Noir #f5a623Paper #8657009.71:1 / 5.96:1 on background
- NoirPaper
--color-primary-foreground
Text on the accent.
Noir #0b0b0cPaper #fbfaf79.71:1 / 5.96:1 on primary
- NoirPaper
--color-success
Available, build passing.
Noir #34d399Paper #0b765610.23:1 / 5.38:1 on background
- NoirPaper
--color-whatsapp
Only the floating WhatsApp button.
Noir #25d366Paper #075e549.92:1 / 7.35:1 on background
- NoirPaper
--color-whatsapp-foreground
Icon on the WhatsApp button.
Noir #0b0b0cPaper #fbfaf79.92:1 / 7.35:1 on whatsapp
- NoirPaper
--color-warning
Caution, archived project.
Noir #facf9ePaper #8a530013.57:1 / 6.06:1 on background
- NoirPaper
--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 · 4pxBetween an icon and its label.
- --spacing-sm0.5rem · 8pxInside badges and buttons.
- --spacing-md1rem · 16pxDefault component padding.
- --spacing-lg1.5rem · 24pxCard padding, between close blocks.
- --spacing-paragraph1.25rem · 20pxBetween Prose paragraphs.
- --spacing-xl2.5rem · 40pxBetween blocks inside a section.
- --spacing-2xl4rem · 64pxBetween sections on phones.
- --spacing-3xl6rem · 96pxBetween sections on desktop.
- --spacing-hero-top12.5rem · 200pxRoom above the hero text on desktop.
- --spacing-hero-bottom7.5rem · 120pxRoom 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
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
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
<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
<StatItem />
A career number. It throws without a label and a context: a bare number misleads.
src/components/ui/StatItem.astro
<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
<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.
<ListRow />
A home list row: the whole row is the link, with a date, up to three markers and an arrow.
src/components/ui/ListRow.astro
<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.