Files
Local_Development/design/design_system/DESIGN.md
T
Noel Sabia e9694bfd2d chore: scaffold local development workspace
Add local docker-compose placeholder and the design system specification
(colours, typography, spacing, components) that the mockups implement.
2026-10-18 13:33:44 +02:00

11 KiB
Raw Blame History

name, colors, typography, rounded, spacing
name colors typography rounded spacing
Noel Sabia — Infrastructure & AI Resilience
surface surface-dim surface-bright surface-container-lowest surface-container-low surface-container surface-container-high surface-container-highest on-surface on-surface-variant inverse-surface inverse-on-surface outline outline-variant surface-tint primary on-primary primary-container on-primary-container inverse-primary secondary on-secondary secondary-container on-secondary-container tertiary on-tertiary tertiary-container on-tertiary-container error on-error error-container on-error-container primary-fixed primary-fixed-dim on-primary-fixed on-primary-fixed-variant secondary-fixed secondary-fixed-dim on-secondary-fixed on-secondary-fixed-variant tertiary-fixed tertiary-fixed-dim on-tertiary-fixed on-tertiary-fixed-variant background on-background surface-variant
#031428 #031428 #2a3a4f #000f22 #0b1c30 #102034 #1b2b3f #26364b #d3e4ff #c3c6cf #d3e4ff #213146 #8d9199 #43474e #a9c9f7 #a9c9f7 #0a3158 #1a3d64 #89a8d5 #406089 #4ae176 #003915 #00b954 #004119 #ffb95f #472a00 #563400 #e79400 #ffb4ab #690005 #93000a #ffdad6 #d3e3ff #a9c9f7 #001c38 #274870 #6bff8f #4ae176 #002109 #005321 #ffddb8 #ffb95f #2a1700 #653e00 #031428 #d3e4ff #26364b
display display-mobile headline-lg headline-lg-mobile headline-md headline-sm body-lg body-md body-sm mono-code label-mono status-badge
fontFamily fontSize fontWeight lineHeight letterSpacing
Newsreader 3.5rem 400 4rem -0.02em
fontFamily fontSize fontWeight lineHeight letterSpacing
Newsreader 2.25rem 400 2.75rem -0.015em
fontFamily fontSize fontWeight lineHeight letterSpacing
Newsreader 2.5rem 400 3rem -0.015em
fontFamily fontSize fontWeight lineHeight letterSpacing
Newsreader 1.75rem 400 2.25rem -0.01em
fontFamily fontSize fontWeight lineHeight letterSpacing
Newsreader 1.75rem 400 2.25rem -0.01em
fontFamily fontSize fontWeight lineHeight letterSpacing
Inter 1.125rem 600 1.5rem -0.005em
fontFamily fontSize fontWeight lineHeight
Inter 1.125rem 400 1.75rem
fontFamily fontSize fontWeight lineHeight
Inter 0.9375rem 400 1.5rem
fontFamily fontSize fontWeight lineHeight
Inter 0.8125rem 400 1.25rem
fontFamily fontSize fontWeight lineHeight
JetBrains Mono 0.875rem 400 1.375rem
fontFamily fontSize fontWeight lineHeight letterSpacing
JetBrains Mono 0.75rem 500 1rem 0.04em
fontFamily fontSize fontWeight lineHeight letterSpacing
JetBrains Mono 0.6875rem 600 0.875rem 0.05em
sm DEFAULT md lg xl full
0.125rem 0.25rem 0.375rem 0.5rem 0.75rem 9999px
gutter gutter-mobile margin margin-mobile space-xs space-sm space-md space-lg space-xl space-2xl
1.5rem 1rem 4rem 1.25rem 0.25rem 0.5rem 1rem 1.5rem 2.5rem 4rem

Brand & Style

This design system establishes the visual and structural language for Noel Sabia’s personal engineering CV and portfolio. Centered on the operational philosophy of resilience—"falling down and standing up again"—the design aesthetic translates chaos engineering, high-availability architecture, and self-healing systems into a quiet, deeply authoritative editorial experience.

Brand Personality & Core Mood

  • Philosophical Rigor: Engineering viewed through durability, steady recovery, and structural endurance rather than transient tech hype.
  • Stoic Minimalism: Uncluttered, generous breathing room. Zero decorative server hardware photos, network stock illustrations, or generic floating node graphs.
  • Precision Craftsmanship: Terminal-grade monospace mechanics married with literary, publication-grade editorial typography to elevate the narrative of failures converted into hardened architecture.

Design Movement

  • Editorial Technical Minimalism: A hybrid of literary publishing (transitional high-readability serifs, measured typographic scales) and crisp UNIX/POSIX utility (monospaced telemetry, subtle window borders, status pills, and structural line delimiters).

Colors

The palette is engineered around an immersive deep maritime slate-navy foundation, punctuated by crisp typographic tiers and precise operational status accents.

Canvas & Surface Hierarchy

  • Base Canvas (#0D1E32): Ultra-deep abyssal slate for body backgrounds and full-bleed margins.
  • Primary Navy (#1A3D64): The core atmospheric hue, framing containers, structural sections, and terminal cards.
  • Surface Elevation (#12273F / #224976): Tiered container fills providing subtle distinction without resorting to heavy drop shadows.

Typographic Contrast

  • Text Primary (#F8FAFC): Crisp, high-contrast cool white for display serifs, headings, and terminal output.
  • Text Secondary (#CBD5E1): Muted bone-slate for longform philosophical narrative and case study bodies.
  • Text Muted / Telemetry (#64748B): Restrained slate for dates, metadata, commit hashes, and system labels.

Operational State Matrix (Chaos & Self-Healing Telemetry)

  • Active / Operational (#22C55E): Pure telemetry emerald for healthy nodes, current roles, and active deployments.
  • Unfinished / Warning (#F59E0B): Warm amber for ongoing architectures, experimental LLM clusters, and in-flight investigations.
  • Failed / Lesson Learned (#EF4444): Soft coral crimson, strictly reserved for post-mortems, decommissioned systems, chaos experiments, and architectural pivots.
  • Finished / Deprecated (#94A3B8): Muted stone-slate for concluded engagements and archived runbooks.

Typography

The typographic pairing balances literary intellect with mechanical systems rigor.

  • Newsreader (Display & Headlines): Imparts reflective authority to high-level essays, experience milestones, and personal statements. It frames Noel's career not as a list of tools, but as an ongoing thesis on resilience.
  • Inter (Body & Narrative): Delivers clean, highly neutral prose legibility for system post-mortems, architectural breakdowns, and role descriptions.
  • JetBrains Mono (System Labels & Metas): Governs metrics, uptime counters, status tags, command-line examples, and timeline coordinate tags.

Layout & Spacing

The layout is built upon an 8-column (tablet) to 12-column (desktop) grid with generous horizontal margins and deliberate vertical intervals to emphasize focus and calm mastery.

Layout Principles

  • Editorial Single/Dual Split: Content max-width is constrained to 68rem (1088px) for body reading comfort, while technical telemetry sidebars pin neatly alongside narrative text.
  • Terminal Gutters: Code snippets, architectural specs, and post-mortem logs use strict standard grid units to keep monospaced output flush with prose boundaries.
  • Breakpoints:
    • sm (0px – 639px): 4-column flow, margins at 1.25rem, unified vertical stacks.
    • md (640px – 1023px): 8-column layout, terminal widgets wrap below case summaries.
    • lg (1024px+): 12-column asymmetric layout with sticky section navigation and persistent systems status telemetry.

Elevation & Depth

Visual hierarchy does not use diffuse, cloudy shadows or high-altitude drop-shadows. Depth is articulated purely through surface values, terminal-style hairline borders, and ambient inset glows.

Tonal Stratification

  • Canvas Base (#0D1E32): Ground level.
  • Window & Module Panels (#12273F): Raised level for experience cards, case studies, and incident reports.
  • Sub-Panels / Code Blocks (#0A1726): Inset level simulating sunken console viewports.

Outlines & Borders

  • Hairline Console Borders: 1px solid borders using #2A4D78 at 60% opacity to demarcate cards without harsh starkness.
  • Focused State: 1px stroke transitioning to #38BDF8 with a subtle 0 0 0 1px rgba(56, 189, 248, 0.3) glow.
  • Status Indicator Shadows: Operational LEDs (#22C55E, #EF4444, etc.) use an ultra-tight, concentrated radial glow (0 0 6px currentColor) to evoke hardware panel lights.

Shapes

The shape vocabulary is deliberate, disciplined, and slightly softened (roundedness: 1 — 0.25rem base radius).

  • Cards & Terminal Panels: 0.375rem (6px) corner radius, preserving the crisp utility of a workstation terminal window while avoiding raw brutalism.
  • Status Pills & Inline Badges: Fully rounded capsule/pill radii (9999px) to create clear contrast between structural layout panels and dynamic status data.
  • Action Buttons & Inputs: 0.25rem (4px) corner radius, providing grounded, tactile reassurance.

Components

1. Terminal Window Cards

  • Header Bar: Height of 2rem (32px), filled with #0E2034, featuring three decorative mini-controls (6px circles in #334155) on the left and a centered monospaced title (Newsreader italic or JetBrains Mono label).
  • Body Area: #12273F container with hairline border (#2A4D78). Generous internal padding (space-lg).

2. Status Indicators & Badges

  • Live Status Pill: Inline-flex, border 1px solid rgba(255, 255, 255, 0.08), background rgba(13, 30, 50, 0.8). Contains a 6px solid dot with an optional subtle pulse animation for #22C55E.
  • Telemetry Tags: Mono typography (label-mono), uppercase, tracking 0.05em. Used for stack metadata (KUBERNETES, TERRAFORM, PYTORCH, EBPF).

3. Incident & Resilience Entry (Post-Mortem Card)

  • Structure: Two-column split on desktop. Left column features date, severity status, and recovery duration. Right column features the incident narrative, the failure condition, and the self-healing remediation implemented.
  • Accent Line: A vertical hairline border on the left edge tinted according to the state (#EF4444 for the initial failure, bridging down to #22C55E for the recovery state).
  • Primary Action (Command Button): Background #F8FAFC, text #0D1E32, font-family: JetBrains Mono, subtle hover inversion to #E2E8F0.
  • Secondary / Ghost Action: Border 1px solid #2A4D78, transparent background, text #F8FAFC. On hover: surface tints to #1A3D64.

5. Architectural Footnotes & Disclosures

  • Collapsible inline drawers for deep-dive technical post-mortems and cluster benchmarks, styled with dashed hairline dividers and monospaced toggle triggers ([+ expand runbook]).