From f6977384b97ad8e2941e1903aaacf5a86b4c079c Mon Sep 17 00:00:00 2001
From: Pontoporeia <pontoporeia@happyngreen.fr>
Date: Tue, 7 Apr 2026 15:13:48 +0200
Subject: [PATCH] migrate to utopia fluid type and space scales across all CSS

---
 TODO.md                         |   1 +
 public/assets/css/admin.css     | 275 ++++++++++++++++----------------
 public/assets/css/apropos.css   |  84 +++++-----
 public/assets/css/common.css    |  26 ++-
 public/assets/css/main.css      |  46 +++---
 public/assets/css/search.css    |  84 +++++-----
 public/assets/css/system.css    | 141 ++++++++--------
 public/assets/css/tfe.css       |  40 ++---
 public/assets/css/variables.css |  38 +++++
 9 files changed, 383 insertions(+), 352 deletions(-)

diff --git a/TODO.md b/TODO.md
index 21b2d7a..be25b56 100644
--- a/TODO.md
+++ b/TODO.md
@@ -2,6 +2,7 @@
 
 ## Done
 - [x] Bump all font sizes ~10% across all CSS files (admin, system, search, main, apropos, common, tfe)
+- [x] Migrate to utopia fluid type scale (--step--2 → --step-5) and space scale (--space-3xs → --space-3xl) across all CSS files
 - [x] Split search logic into search.php
   - [x] `public/search.php` — new page for text-query search results
   - [x] `public/repertoire.php` — stripped to répertoire index only
diff --git a/public/assets/css/admin.css b/public/assets/css/admin.css
index fd0c8e3..8ea12de 100644
--- a/public/assets/css/admin.css
+++ b/public/assets/css/admin.css
@@ -32,18 +32,18 @@
 
 .admin-body main {
     flex: 1;
-    padding: 2.5rem 2rem 4rem;
+    padding: var(--space-l) var(--space-l) var(--space-2xl);
     max-width: 1100px;
     width: 100%;
     margin-inline: auto;
 }
 
 .admin-body main > h1 {
-    font-size: 1.98rem;
+    font-size: var(--step-2);
     font-weight: 600;
     letter-spacing: 0.08em;
     text-transform: uppercase;
-    margin: 0 0 2.5rem 0;
+    margin: 0 0 var(--space-l) 0;
 }
 
 /* ── Forms ─────────────────────────────────────────────────────────────── */
@@ -58,8 +58,8 @@
     grid-template-columns: 260px 1fr;
     align-items: start;
     border-top: 1px solid var(--border-primary);
-    padding: 0.75rem 0;
-    gap: 1rem;
+    padding: var(--space-xs) 0;
+    gap: var(--space-s);
 }
 
 .admin-form > div:not(.admin-form-footer):last-of-type {
@@ -68,8 +68,8 @@
 
 .admin-form > div:not(.admin-form-footer) > label,
 .admin-form > div:not(.admin-form-footer) > span.admin-row-label {
-    font-size: 1.01rem;
-    padding-top: 0.5rem;
+    font-size: var(--step--1);
+    padding-top: var(--space-2xs);
     font-weight: 400;
 }
 
@@ -86,9 +86,9 @@
     background: transparent;
     border: none;
     border-bottom: 1px solid var(--border-primary);
-    font-size: 1.01rem;
+    font-size: var(--step--1);
     font-family: inherit;
-    padding: 0.4rem 0;
+    padding: var(--space-3xs) 0;
     border-radius: 0;
     transition: border-color 0.15s;
     -webkit-appearance: none;
@@ -109,7 +109,7 @@
 
 .admin-form input::placeholder,
 .admin-form textarea::placeholder {
-    font-size: 0.97rem;
+    font-size: var(--step--1);
     color: var(--text-tertiary);
 }
 
@@ -133,14 +133,14 @@
 .admin-file-input {
     display: flex;
     flex-direction: column;
-    gap: 0.25rem;
+    gap: var(--space-3xs);
 }
 
 .admin-file-input input[type="file"] {
-    font-size: 0.94rem;
+    font-size: var(--step--1);
     background: transparent;
     border: 1px dashed var(--border-primary);
-    padding: 0.4rem 0.6rem;
+    padding: var(--space-3xs) var(--space-2xs);
     border-radius: 3px;
     cursor: pointer;
     font-family: inherit;
@@ -151,16 +151,13 @@
 }
 
 .admin-body form small {
-    font-size: 0.86rem;
+    font-size: var(--step--2);
     color: var(--text-secondary);
-    margin-top: 0.15rem;
+    margin-top: var(--space-3xs);
     display: block;
 }
 
-/* Checkbox group fieldset (languages, formats)
-   Wraps the <ul> of checkboxes; the visible label is a sibling <span>
-   in the grid row. The <legend> repeats the label text for AT only (sr-only).
-   .admin-body scope ensures this overrides the generic .admin-body fieldset rule. */
+/* Checkbox group fieldset (languages, formats) */
 .admin-body fieldset.admin-checkbox-group {
     border: none;
     padding: 0;
@@ -171,21 +168,21 @@
 .admin-body fieldset.admin-checkbox-group > ul {
     list-style: none;
     margin: 0;
-    padding-top: 0.3rem;
+    padding-top: var(--space-3xs);
     display: flex;
     flex-direction: column;
-    gap: 0.35rem;
+    gap: var(--space-3xs);
 }
 
 .admin-body fieldset.admin-checkbox-group > ul > li {
-    display: contents; /* let the inner label handle layout */
+    display: contents;
 }
 
 .admin-checkbox-label {
     display: flex;
     align-items: center;
-    gap: 0.5rem;
-    font-size: 0.99rem;
+    gap: var(--space-2xs);
+    font-size: var(--step--1);
     cursor: pointer;
 }
 
@@ -199,33 +196,33 @@
 /* Fieldset / legend (jury) */
 .admin-body fieldset {
     border: 1px solid var(--border-primary);
-    padding: 1rem 1.25rem;
-    margin: 0.5rem 0 1rem;
+    padding: var(--space-s) var(--space-m);
+    margin: var(--space-2xs) 0 var(--space-s);
     background: var(--bg-secondary);
 }
 
 .admin-body legend {
-    font-size: 0.9rem;
+    font-size: var(--step--1);
     font-weight: 600;
     letter-spacing: 0.04em;
     text-transform: uppercase;
     color: var(--text-secondary);
-    padding: 0 0.5rem;
+    padding: 0 var(--space-2xs);
 }
 
 /* ── Buttons ────────────────────────────────────────────────────────────── */
 .admin-form-footer {
-    margin-top: 2rem;
-    padding-top: 1.5rem;
+    margin-top: var(--space-l);
+    padding-top: var(--space-m);
 }
 
 .admin-btn {
-    padding: 0.65rem 2.5rem;
+    padding: var(--space-2xs) var(--space-l);
     background: var(--accent-primary);
     color: var(--accent-foreground);
     border: none;
     border-radius: 3px;
-    font-size: 1.01rem;
+    font-size: var(--step--1);
     font-family: inherit;
     cursor: pointer;
     letter-spacing: 0.04em;
@@ -239,12 +236,12 @@
 }
 
 .admin-btn-secondary {
-    padding: 0.5rem 1.5rem;
+    padding: var(--space-3xs) var(--space-m);
     background: transparent;
     color: var(--text-tertiary);
     border: 1px solid var(--border-primary);
     border-radius: 3px;
-    font-size: 0.97rem;
+    font-size: var(--step--1);
     font-family: inherit;
     cursor: pointer;
     letter-spacing: 0.04em;
@@ -260,8 +257,8 @@
 
 /* Small size modifier */
 .admin-btn--sm {
-    padding: 0.28rem 0.65rem;
-    font-size: 0.9rem;
+    padding: var(--space-3xs) var(--space-2xs);
+    font-size: var(--step--2);
 }
 
 /* Semantic colour modifiers */
@@ -286,10 +283,10 @@
 /* ── Alert messages ─────────────────────────────────────────────────────── */
 [role="alert"],
 [role="status"] {
-    padding: 0.75rem 1rem;
+    padding: var(--space-xs) var(--space-s);
     border-radius: 3px;
-    font-size: 0.99rem;
-    margin-bottom: 1.5rem;
+    font-size: var(--step--1);
+    margin-bottom: var(--space-m);
     border-left: 3px solid;
 }
 
@@ -308,8 +305,8 @@
 /* ── Stats cards ────────────────────────────────────────────────────────── */
 .admin-stats {
     display: flex;
-    gap: 1rem;
-    margin-bottom: 2rem;
+    gap: var(--space-s);
+    margin-bottom: var(--space-l);
     flex-wrap: wrap;
 }
 
@@ -317,14 +314,14 @@
     background: var(--bg-secondary);
     border: 1px solid var(--border-primary);
     border-radius: 4px;
-    padding: 1rem 1.5rem;
+    padding: var(--space-s) var(--space-m);
     min-width: 140px;
     display: flex;
     flex-direction: column;
 }
 
 .admin-stat__number {
-    font-size: 2.2rem;
+    font-size: var(--step-3);
     font-weight: 700;
     color: var(--accent-primary);
     line-height: 1;
@@ -333,9 +330,9 @@
 }
 
 .admin-stat__label {
-    font-size: 0.9rem;
+    font-size: var(--step--1);
     color: var(--text-secondary);
-    margin-top: 0.25rem;
+    margin-top: var(--space-3xs);
     order: 2;
 }
 
@@ -344,13 +341,13 @@
     display: flex;
     align-items: center;
     justify-content: space-between;
-    gap: 1rem;
+    gap: var(--space-s);
     background: var(--bg-secondary);
     border: 1px solid var(--border-primary);
     border-radius: 4px;
-    padding: 0.65rem 1rem;
-    margin-bottom: 1.5rem;
-    font-size: 0.97rem;
+    padding: var(--space-2xs) var(--space-s);
+    margin-bottom: var(--space-m);
+    font-size: var(--step--1);
 }
 
 .admin-maintenance-bar--active {
@@ -366,27 +363,27 @@
 /* Result-count line above the thesis table */
 .admin-list-meta {
     color: var(--text-secondary);
-    font-size: 0.94rem;
-    margin-bottom: 0.5rem;
+    font-size: var(--step--1);
+    margin-bottom: var(--space-2xs);
 }
 
 /* Empty-state message below the thesis table */
 .admin-empty {
     color: var(--text-secondary);
-    padding: 1rem 0;
+    padding: var(--space-s) 0;
 }
 
 /* Identifier column in the thesis table */
 .admin-table-id {
     color: var(--text-secondary);
-    font-size: 0.88rem;
+    font-size: var(--step--2);
 }
 
 /* ── Filters bar ────────────────────────────────────────────────────────── */
 .admin-filters {
     display: flex;
-    gap: 0.75rem;
-    margin-bottom: 1.5rem;
+    gap: var(--space-xs);
+    margin-bottom: var(--space-m);
     flex-wrap: wrap;
     align-items: flex-end;
 }
@@ -395,9 +392,9 @@
 .admin-filters select {
     border: 1px solid var(--border-primary);
     border-radius: 3px;
-    font-size: 0.97rem;
+    font-size: var(--step--1);
     font-family: inherit;
-    padding: 0.45rem 0.75rem;
+    padding: var(--space-3xs) var(--space-xs);
     background: transparent;
     cursor: pointer;
 }
@@ -409,12 +406,12 @@
 }
 
 .admin-filters-btn {
-    padding: 0.45rem 1rem;
+    padding: var(--space-3xs) var(--space-s);
     background: var(--accent-primary);
     color: var(--accent-foreground);
     border: none;
     border-radius: 3px;
-    font-size: 0.97rem;
+    font-size: var(--step--1);
     font-family: inherit;
     cursor: pointer;
     transition: background 0.15s;
@@ -425,7 +422,7 @@
 }
 
 .admin-filters-reset {
-    font-size: 0.97rem;
+    font-size: var(--step--1);
     color: var(--text-secondary);
     text-decoration: underline;
     cursor: pointer;
@@ -435,37 +432,37 @@
 .admin-bulk-actions {
     display: none;
     align-items: center;
-    gap: 1rem;
-    padding: 0.6rem 1rem;
+    gap: var(--space-s);
+    padding: var(--space-2xs) var(--space-s);
     background: var(--bg-secondary);
     border: 1px solid var(--border-primary);
     border-radius: 4px;
-    margin-bottom: 1rem;
-    font-size: 0.97rem;
+    margin-bottom: var(--space-s);
+    font-size: var(--step--1);
 }
 
 .admin-bulk-btns {
     display: flex;
-    gap: 0.5rem;
+    gap: var(--space-2xs);
 }
 
 /* ── Table ──────────────────────────────────────────────────────────────── */
 .admin-body table {
     width: 100%;
     border-collapse: collapse;
-    font-size: 0.97rem;
+    font-size: var(--step--1);
 }
 
 .admin-body main > table {
-    margin-top: 1.5rem;
+    margin-top: var(--space-m);
 }
 
 .admin-body table th {
     text-align: left;
-    font-size: 0.83rem;
+    font-size: var(--step--2);
     letter-spacing: 0.08em;
     text-transform: uppercase;
-    padding: 0.5rem 0.75rem;
+    padding: var(--space-3xs) var(--space-xs);
     border-bottom: 1px solid var(--border-primary);
     color: var(--text-secondary);
     font-weight: 400;
@@ -473,7 +470,7 @@
 }
 
 .admin-body table td {
-    padding: 0.65rem 0.75rem;
+    padding: var(--space-2xs) var(--space-xs);
     border-bottom: 1px solid var(--border-primary);
     vertical-align: top;
 }
@@ -487,7 +484,7 @@
 }
 
 .admin-body table .thesis-subtitle {
-    font-size: 0.9rem;
+    font-size: var(--step--1);
     color: var(--text-secondary);
     font-style: italic;
 }
@@ -495,9 +492,9 @@
 /* ── Status badges ──────────────────────────────────────────────────────── */
 .status-badge {
     display: inline-block;
-    padding: 0.2rem 0.5rem;
+    padding: var(--space-3xs) var(--space-2xs);
     border-radius: 3px;
-    font-size: 0.86rem;
+    font-size: var(--step--2);
     font-weight: 500;
     letter-spacing: 0.04em;
 }
@@ -514,8 +511,8 @@
 
 .status-access {
     display: inline-block;
-    font-size: 0.77rem;
-    padding: 0.1rem 0.4rem;
+    font-size: var(--step--2);
+    padding: var(--space-3xs) var(--space-3xs);
     border-radius: 3px;
     background: var(--bg-tertiary);
     color: var(--text-secondary);
@@ -540,15 +537,15 @@
 /* ── Action buttons in table ────────────────────────────────────────────── */
 .admin-actions {
     display: flex;
-    gap: 0.4rem;
+    gap: var(--space-3xs);
     flex-wrap: wrap;
 }
 
 .admin-btn-sm {
-    padding: 0.25rem 0.6rem;
+    padding: var(--space-3xs) var(--space-2xs);
     min-height: 2rem;
     border-radius: 3px;
-    font-size: 0.86rem;
+    font-size: var(--step--2);
     font-family: inherit;
     cursor: pointer;
     text-decoration: none;
@@ -604,38 +601,38 @@
 .admin-body main > section {
     border: 1px solid var(--border-primary);
     border-radius: 6px;
-    padding: 1.5rem;
-    margin-bottom: 1.5rem;
+    padding: var(--space-m);
+    margin-bottom: var(--space-m);
 }
 
 .admin-body main > section h2 {
-    margin: 0 0 1rem;
-    font-size: 1.32rem;
+    margin: 0 0 var(--space-s);
+    font-size: var(--step-1);
     border-bottom: 1px solid var(--border-primary);
-    padding-bottom: 0.5rem;
+    padding-bottom: var(--space-2xs);
 }
 
 .admin-body main > section dl {
     display: grid;
     grid-template-columns: 180px 1fr;
-    gap: 0.4rem 1rem;
+    gap: var(--space-3xs) var(--space-s);
 }
 
 .admin-body main > section dt {
     font-weight: 600;
-    font-size: 0.97rem;
+    font-size: var(--step--1);
     color: var(--text-secondary);
 }
 
 .admin-body main > section dd {
     margin: 0;
-    font-size: 0.99rem;
+    font-size: var(--step--1);
 }
 
 .admin-action-bar {
-    margin-top: 1.5rem;
+    margin-top: var(--space-m);
     display: flex;
-    gap: 0.75rem;
+    gap: var(--space-xs);
     flex-wrap: wrap;
 }
 
@@ -645,13 +642,13 @@
 
 /* ── Section titles (account, etc.) ─────────────────────────────────────── */
 .admin-section-title {
-    font-size: 1.1rem;
+    font-size: var(--step-0);
     font-weight: 600;
     letter-spacing: 0.07em;
     text-transform: uppercase;
     color: var(--text-secondary);
-    margin: 2rem 0 1rem;
-    padding-bottom: 0.5rem;
+    margin: var(--space-l) 0 var(--space-s);
+    padding-bottom: var(--space-2xs);
     border-bottom: 1px solid var(--border-primary);
 }
 
@@ -664,18 +661,18 @@
 .admin-account-status {
     border: 1px solid var(--border-primary);
     border-radius: 4px;
-    padding: 1rem 1.5rem;
-    margin-bottom: 2rem;
+    padding: var(--space-s) var(--space-m);
+    margin-bottom: var(--space-l);
     display: flex;
     flex-direction: column;
-    gap: 0.75rem;
+    gap: var(--space-xs);
 }
 
 .admin-account-status__row {
     display: flex;
     align-items: center;
-    gap: 0.75rem;
-    font-size: 0.99rem;
+    gap: var(--space-xs);
+    font-size: var(--step--1);
 }
 
 .admin-account-status__label {
@@ -685,16 +682,16 @@
 
 .admin-account-status__code {
     font-family: ui-monospace, "SFMono-Regular", Consolas, monospace;
-    font-size: 0.9rem;
+    font-size: var(--step--2);
     border: 1px solid var(--border-primary);
     border-radius: 3px;
-    padding: 0.1rem 0.4rem;
+    padding: var(--space-3xs) var(--space-3xs);
     color: var(--text-secondary);
     background: var(--bg-secondary);
 }
 
 .admin-account-status__note {
-    font-size: 0.94rem;
+    font-size: var(--step--1);
     color: var(--text-secondary);
     margin: 0;
 }
@@ -703,16 +700,16 @@
 .admin-danger-zone {
     border: 1px solid var(--danger-border-muted);
     border-radius: 4px;
-    padding: 1.25rem 1.5rem;
+    padding: var(--space-m) var(--space-m);
     display: flex;
     align-items: center;
-    gap: 1.5rem;
+    gap: var(--space-m);
     flex-wrap: wrap;
 }
 
 .admin-danger-zone__description {
     flex: 1;
-    font-size: 0.99rem;
+    font-size: var(--step--1);
 }
 
 /* ── Login page ─────────────────────────────────────────────────────────── */
@@ -727,14 +724,14 @@
     background: var(--bg-secondary);
     border: 1px solid var(--border-primary);
     border-radius: 4px;
-    padding: 2rem;
+    padding: var(--space-l);
     width: 100%;
     max-width: 380px;
 }
 
 .admin-login-box h2 {
-    margin: 0 0 1.5rem;
-    font-size: 1.21rem;
+    margin: 0 0 var(--space-m);
+    font-size: var(--step-0);
     font-weight: 500;
     text-align: center;
 }
@@ -742,18 +739,18 @@
 .admin-login-box .admin-form > div:not(.admin-form-footer) {
     grid-template-columns: 1fr;
     border: none;
-    padding: 0.4rem 0;
+    padding: var(--space-3xs) 0;
 }
 
 .admin-login-box .admin-form > div:not(.admin-form-footer) > label {
-    font-size: 0.9rem;
+    font-size: var(--step--1);
     color: var(--text-secondary);
-    margin-bottom: 0.2rem;
+    margin-bottom: var(--space-3xs);
 }
 
 .admin-login-box .admin-form-footer {
-    margin-top: 1rem;
-    padding-top: 0.5rem;
+    margin-top: var(--space-s);
+    padding-top: var(--space-2xs);
 }
 
 .admin-login-box .admin-btn {
@@ -764,30 +761,30 @@
 .admin-import-area {
     display: flex;
     flex-direction: column;
-    gap: 1.5rem;
+    gap: var(--space-m);
 }
 
 /* Error list inside role="alert" (import page) */
 .admin-error-list {
-    margin: 0.5rem 0 0;
-    padding-left: 1.2rem;
+    margin: var(--space-2xs) 0 0;
+    padding-left: var(--space-s);
 }
 
 /* Hint text under the file input (import page) */
 .admin-file-hint {
     display: block;
-    margin-top: 0.5rem;
+    margin-top: var(--space-2xs);
 }
 
 /* Import results panel */
 .admin-import-results {
-    margin-top: 2rem;
+    margin-top: var(--space-l);
 }
 
 .admin-import-results__title {
-    font-size: 1.1rem;
+    font-size: var(--step-0);
     font-weight: 600;
-    margin-bottom: 0.75rem;
+    margin-bottom: var(--space-xs);
     color: var(--text-secondary);
     text-transform: uppercase;
     letter-spacing: 0.06em;
@@ -797,41 +794,39 @@
 
 /* ── Jury fieldset ──────────────────────────────────────────────────────── */
 
-/* Nested lecteur·ices fieldset sits inside the outer jury fieldset:
-   strip heavy border/background so it reads as a sub-group, not a card. */
 .admin-body fieldset fieldset.admin-jury-lecteurs {
     border: none;
     padding: 0;
-    margin: 0.75rem 0 0;
+    margin: var(--space-xs) 0 0;
     background: transparent;
 }
 
 .admin-body fieldset fieldset.admin-jury-lecteurs > legend {
-    font-size: 0.86rem;
+    font-size: var(--step--2);
     font-weight: 600;
     letter-spacing: 0.03em;
     text-transform: uppercase;
     color: var(--text-tertiary);
     padding: 0;
-    margin-bottom: 0.5rem;
+    margin-bottom: var(--space-2xs);
 }
 
 .admin-jury-row {
     display: flex;
-    gap: 0.75rem;
+    gap: var(--space-xs);
     flex-wrap: wrap;
 }
 
 .admin-jury-list {
     display: flex;
     flex-direction: column;
-    gap: 0.5rem;
+    gap: var(--space-2xs);
 }
 
 .admin-jury-entry {
     display: flex;
     align-items: center;
-    gap: 0.75rem;
+    gap: var(--space-xs);
 }
 
 .admin-jury-ext {
@@ -843,9 +838,9 @@
     border: 1px solid var(--border-primary);
     color: var(--text-tertiary);
     border-radius: 3px;
-    padding: 0.2rem 0.55rem;
+    padding: var(--space-3xs) var(--space-2xs);
     min-height: 2rem;
-    font-size: 0.88rem;
+    font-size: var(--step--2);
     line-height: 1;
     display: inline-flex;
     align-items: center;
@@ -864,25 +859,25 @@
 .admin-inline-form {
     display: flex;
     align-items: center;
-    gap: 0.4rem;
+    gap: var(--space-3xs);
     flex-wrap: wrap;
 }
 
 .admin-input--inline,
 .admin-inline-form input[type="text"] {
-    font-size: 0.9rem;
+    font-size: var(--step--1);
     width: 160px;
 }
 
 .admin-select--inline,
 .admin-inline-form select {
-    font-size: 0.9rem;
+    font-size: var(--step--1);
     width: 160px;
 }
 
 /* Stack secondary forms (merge, delete) below the rename form */
 .admin-inline-form + .admin-inline-form {
-    margin-top: 0.35rem;
+    margin-top: var(--space-3xs);
 }
 
 /* Tags table column sizing */
@@ -907,12 +902,12 @@
     border: 1px solid var(--border-primary);
     border-radius: 3px;
     display: block;
-    margin-top: 0.5rem;
+    margin-top: var(--space-2xs);
 }
 
 /* ── Cancel link ────────────────────────────────────────────────────────── */
 .admin-cancel-link {
-    font-size: 0.97rem;
+    font-size: var(--step--1);
     color: var(--text-secondary);
     text-decoration: underline;
 }
@@ -922,13 +917,13 @@
     display: flex;
     justify-content: center;
     align-items: center;
-    gap: 0.5rem;
-    padding: 1.5rem 0 0.5rem;
+    gap: var(--space-2xs);
+    padding: var(--space-m) 0 var(--space-2xs);
 }
 
 .admin-body .pagination-wrap ul {
     display: flex;
-    gap: 0.25rem;
+    gap: var(--space-3xs);
     list-style: none;
     margin: 0;
     padding: 0;
@@ -940,11 +935,11 @@
     justify-content: center;
     min-width: 2.75rem;
     min-height: 2.75rem;
-    padding: 0 0.6rem;
+    padding: 0 var(--space-2xs);
     border: 1px solid var(--border-secondary);
     border-radius: 3px;
     color: var(--text-primary);
-    font-size: 0.99rem;
+    font-size: var(--step--1);
     text-decoration: none;
     transition:
         border-color 0.15s,
@@ -963,9 +958,9 @@
 }
 
 .admin-body .pagination-info {
-    font-size: 0.99rem;
+    font-size: var(--step--1);
     color: var(--text-secondary);
-    padding: 0 0.5rem;
+    padding: 0 var(--space-2xs);
 }
 
 .admin-body #editor {
diff --git a/public/assets/css/apropos.css b/public/assets/css/apropos.css
index 25ceff4..cfdc410 100644
--- a/public/assets/css/apropos.css
+++ b/public/assets/css/apropos.css
@@ -17,7 +17,7 @@
 
 .apropos-main {
   flex: 1;
-  padding: 3rem 2rem 5rem;
+  padding: var(--space-xl) var(--space-l) var(--space-2xl);
 }
 
 /* ------------------------------------------------------------------ */
@@ -27,7 +27,7 @@
 .apropos-layout {
   display: grid;
   grid-template-columns: 180px 1fr;
-  gap: 4rem;
+  gap: var(--space-2xl);
   max-width: 860px;
   margin: 0 auto;
   align-items: start;
@@ -39,38 +39,38 @@
 
 .apropos-toc {
   position: sticky;
-  top: 2.5rem;
+  top: var(--space-l);
 }
 
 .apropos-toc-label {
   font-family: var(--font-body);
-  font-size: 0.79rem;
+  font-size: var(--step--2);
   font-weight: 600;
   letter-spacing: 0.12em;
   text-transform: uppercase;
   color: var(--text-tertiary);
-  margin: 0 0 0.6rem 0;
+  margin: 0 0 var(--space-2xs) 0;
 }
 
 .apropos-toc ul {
   list-style: none;
-  margin: 0 0 1.5rem 0;
+  margin: 0 0 var(--space-m) 0;
   padding: 0;
   display: flex;
   flex-direction: column;
-  gap: 0.25rem;
+  gap: var(--space-3xs);
 }
 
 .apropos-toc ul a {
   font-family: var(--font-body);
-  font-size: 0.96rem;
+  font-size: var(--step--1);
   color: var(--text-secondary);
   text-decoration: none;
   display: block;
-  padding: 0.2rem 0;
+  padding: var(--space-3xs) 0;
   transition: color 0.15s;
   border-left: 2px solid transparent;
-  padding-left: 0.6rem;
+  padding-left: var(--space-2xs);
 }
 
 .apropos-toc ul a:hover {
@@ -79,12 +79,12 @@
 }
 
 .apropos-toc-erg {
-  padding-top: 1rem;
+  padding-top: var(--space-s);
   border-top: 1px solid var(--border-primary);
 }
 
 .apropos-toc-erg a {
-  font-size: 0.88rem;
+  font-size: var(--step--2);
   color: var(--accent-primary);
   text-decoration: none;
   transition: opacity 0.15s;
@@ -105,9 +105,9 @@
 }
 
 .apropos-section {
-  padding-bottom: 3.5rem;
+  padding-bottom: var(--space-xl);
   border-bottom: 1px solid var(--border-primary);
-  margin-bottom: 3.5rem;
+  margin-bottom: var(--space-xl);
 }
 
 .apropos-section:last-child {
@@ -122,10 +122,10 @@
 
 .apropos-section-title {
   font-family: var(--font-display);
-  font-size: 2.2rem;
+  font-size: var(--step-3);
   font-weight: 400;
   color: var(--text-primary);
-  margin: 0 0 1.75rem 0;
+  margin: 0 0 var(--space-m) 0;
   line-height: 1.1;
 }
 
@@ -135,8 +135,8 @@
 
 .prose {
   font-family: var(--font-body);
-  font-size: 1.59rem;
-  line-height: 1.5;
+  font-size: var(--step-0);
+  line-height: 1.6;
   color: var(--text-primary);
   font-weight: 400;
 }
@@ -157,9 +157,9 @@
   margin: 1.5em 0 0.5em 0;
 }
 
-.prose h1 { font-size: 2.2rem; }
-.prose h2 { font-size: 1.65rem; }
-.prose h3 { font-size: 1.32rem; }
+.prose h1 { font-size: var(--step-3); }
+.prose h2 { font-size: var(--step-2); }
+.prose h3 { font-size: var(--step-1); }
 
 .prose a {
   color: var(--accent-primary);
@@ -169,8 +169,8 @@
 
 .prose ul,
 .prose ol {
-  padding-left: 1.5rem;
-  margin-bottom: 1rem;
+  padding-left: var(--space-m);
+  margin-bottom: var(--space-s);
 }
 
 .prose li {
@@ -200,7 +200,7 @@
 
 .apropos-contact-card {
   font-style: normal;
-  padding: 1.1rem 0;
+  padding: var(--space-s) 0;
   border-bottom: 1px solid var(--border-primary);
 }
 
@@ -210,22 +210,22 @@
 
 .apropos-contact-card strong {
   display: block;
-  font-size: 1.04rem;
+  font-size: var(--step-0);
   font-weight: 600;
   color: var(--text-primary);
-  margin-bottom: 0.2rem;
+  margin-bottom: var(--space-3xs);
 }
 
 .apropos-contact-card span {
   display: block;
-  font-size: 0.94rem;
+  font-size: var(--step--1);
   color: var(--text-secondary);
   line-height: 1.4;
-  margin-bottom: 0.25rem;
+  margin-bottom: var(--space-3xs);
 }
 
 .apropos-contact-card a {
-  font-size: 0.94rem;
+  font-size: var(--step--1);
   color: var(--accent-primary);
   text-decoration: underline;
   text-underline-offset: 2px;
@@ -251,8 +251,8 @@
 .apropos-credit-row {
   display: grid;
   grid-template-columns: 1fr 1.6fr;
-  gap: 1rem;
-  padding: 1rem 0;
+  gap: var(--space-s);
+  padding: var(--space-s) 0;
   border-bottom: 1px solid var(--border-primary);
   align-items: baseline;
 }
@@ -262,7 +262,7 @@
 }
 
 .apropos-credits-list dt {
-  font-size: 0.88rem;
+  font-size: var(--step--2);
   font-weight: 600;
   letter-spacing: 0.04em;
   text-transform: uppercase;
@@ -270,7 +270,7 @@
 }
 
 .apropos-credits-list dd {
-  font-size: 0.99rem;
+  font-size: var(--step--1);
   color: var(--text-primary);
   margin: 0;
   line-height: 1.5;
@@ -291,7 +291,7 @@
 @media (max-width: 900px) {
   .apropos-layout {
     grid-template-columns: 1fr;
-    gap: 2rem;
+    gap: var(--space-l);
   }
 
   .apropos-toc {
@@ -299,8 +299,8 @@
     display: flex;
     flex-wrap: wrap;
     align-items: center;
-    gap: 1rem;
-    padding-bottom: 1rem;
+    gap: var(--space-s);
+    padding-bottom: var(--space-s);
     border-bottom: 1px solid var(--border-primary);
   }
 
@@ -311,7 +311,7 @@
   .apropos-toc ul {
     flex-direction: row;
     margin: 0;
-    gap: 0.75rem;
+    gap: var(--space-xs);
   }
 
   .apropos-toc ul a {
@@ -326,25 +326,25 @@
   }
 
   .prose {
-    font-size: 1.32rem;
+    font-size: var(--step-0);
   }
 
   .apropos-section-title {
-    font-size: 1.76rem;
+    font-size: var(--step-2);
   }
 }
 
 @media (max-width: 600px) {
   .apropos-main {
-    padding: 1.5rem 1rem 3rem;
+    padding: var(--space-m) var(--space-s) var(--space-xl);
   }
 
   .prose {
-    font-size: 1.1rem;
+    font-size: var(--step-0);
   }
 
   .apropos-credit-row {
     grid-template-columns: 1fr;
-    gap: 0.25rem;
+    gap: var(--space-3xs);
   }
 }
diff --git a/public/assets/css/common.css b/public/assets/css/common.css
index 7bc161e..92bbaf2 100644
--- a/public/assets/css/common.css
+++ b/public/assets/css/common.css
@@ -85,7 +85,7 @@ body > header {
 }
 
 body > header nav {
-  padding: 1.44rem 1.5rem;
+  padding: var(--space-s) var(--space-s);
   display: flex;
   align-items: center;
   justify-content: space-between;
@@ -94,13 +94,13 @@ body > header nav {
 .nav-left {
   display: flex;
   align-items: center;
-  gap: 3rem;
+  gap: var(--space-l);
 }
 
 .nav-left-links,
 .nav-right-links {
   display: flex;
-  gap: 3rem;
+  gap: var(--space-l);
   align-items: center;
   list-style: none;
   margin: 0;
@@ -109,17 +109,16 @@ body > header nav {
 
 body > header nav > a {
   font-family: var(--font-display);
-  font-size: 1.21rem;
+  font-size: var(--step-0);
   letter-spacing: 0.12em;
   text-transform: uppercase;
   color: var(--accent-foreground);
   text-decoration: none;
-  /* font-weight: 400; */
 }
 
 body > header nav > ul {
   display: flex;
-  gap: 3rem;
+  gap: var(--space-l);
   align-items: center;
   list-style: none;
   margin: 0;
@@ -127,12 +126,11 @@ body > header nav > ul {
 }
 
 body > header nav ul a {
-  font-size: 1.04rem;
+  font-size: var(--step--1);
   letter-spacing: 0.12em;
   text-transform: uppercase;
   color: var(--accent-foreground);
   text-decoration: none;
-  /* font-weight: 400; */
   transition: opacity 0.15s;
 }
 
@@ -162,8 +160,8 @@ body > header nav ul a[aria-current="page"] {
 body > header form[role="search"] {
   display: flex;
   align-items: center;
-  gap: 0.5rem;
-  padding: 0.4rem 1.5rem;
+  gap: var(--space-2xs);
+  padding: var(--space-3xs) var(--space-s);
   border: 1px solid var(--accent-primary);
   border-radius: 0;
   background: var(--bg-primary);
@@ -182,10 +180,10 @@ body > header form[role="search"] svg {
 body > header form[role="search"] input {
   flex: 1;
   border: none;
-  font-size: 1.04rem;
+  font-size: var(--step--1);
   color: var(--text-primary);
   background: transparent;
-  padding: 0.15rem 0;
+  padding: var(--space-3xs) 0;
   font-family: inherit;
 }
 
@@ -216,10 +214,10 @@ body > header form[role="search"] input::placeholder {
   top: -999px;
   left: 1rem;
   z-index: 9999;
-  padding: 0.5rem 1rem;
+  padding: var(--space-2xs) var(--space-s);
   background: var(--accent-primary);
   color: var(--text-primary);
-  font-size: 0.99rem;
+  font-size: var(--step--1);
   font-weight: 600;
   text-decoration: none;
   border-radius: 0 0 4px 4px;
diff --git a/public/assets/css/main.css b/public/assets/css/main.css
index 5343e38..7f80b5f 100644
--- a/public/assets/css/main.css
+++ b/public/assets/css/main.css
@@ -23,10 +23,10 @@
 .cards-container {
   display: grid;
   grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
-  gap: 1.25rem;
+  gap: var(--space-s);
   list-style: none;
   margin: 0;
-  padding: 1rem 1.25rem 1.5rem;
+  padding: var(--space-xs) var(--space-s) var(--space-m);
 }
 
 @media (min-width: 1400px) {
@@ -100,7 +100,7 @@
   align-items: center;
   justify-content: center;
   color: var(--text-tertiary);
-  font-size: 2.2rem;
+  font-size: var(--step-3);
 }
 
 .card__media--gradient {
@@ -110,7 +110,7 @@
   flex-direction: column;
   align-items: center;
   justify-content: center;
-  padding: 1rem;
+  padding: var(--space-s);
   text-align: center;
   box-sizing: border-box;
   border-radius: 7px 7px 0 0;
@@ -118,7 +118,7 @@
 
 .card__gradient-author {
   color: var(--accent-foreground);
-  font-size: 0.83rem;
+  font-size: var(--step--2);
   opacity: .85;
   margin-bottom: .25rem;
   display: block;
@@ -126,7 +126,7 @@
 
 .card__gradient-title {
   color: var(--accent-foreground);
-  font-size: 0.94rem;
+  font-size: var(--step--1);
   font-weight: 600;
   display: -webkit-box;
   -webkit-line-clamp: 3;
@@ -139,19 +139,19 @@
   font-style: normal;
   background: transparent;
   color: var(--text-primary);
-  font-size: 0.86rem;
+  font-size: var(--step--2);
   font-weight: 600;
   letter-spacing: 0.1em;
   text-transform: uppercase;
-  padding: 1.1rem 1.25rem 0.8rem;
+  padding: var(--space-s) var(--space-s) var(--space-xs);
   border-bottom: 1px solid var(--border-primary);
   margin: 0;
 }
 
 /* Card caption — <p> directly inside the card <a> link, below the media */
 .home-body li > a > p {
-  padding: 0.55rem 0.75rem 0.65rem;
-  font-size: 0.97rem;
+  padding: var(--space-2xs) var(--space-xs) var(--space-xs);
+  font-size: var(--step--1);
   line-height: 1.35;
   color: var(--text-primary);
   margin: 0;
@@ -161,9 +161,9 @@
 
 /* Empty-state message shown when no cards exist */
 .cards-empty {
-  padding: 2rem;
+  padding: var(--space-l);
   color: var(--text-tertiary);
-  font-size: 0.99rem;
+  font-size: var(--step--1);
   list-style: none;
 }
 
@@ -171,21 +171,21 @@
 .filter-info {
   background: var(--accent-muted);
   color: var(--accent-secondary);
-  padding: 0.4rem 1.5rem;
-  font-size: 0.94rem;
+  padding: var(--space-3xs) var(--space-s);
+  font-size: var(--step--1);
   display: flex;
   align-items: center;
-  gap: 1rem;
+  gap: var(--space-s);
   flex-shrink: 0;
 }
 
 .clear-filter {
   color: var(--accent-secondary);
   text-decoration: none;
-  padding: 0.15rem 0.6rem;
+  padding: var(--space-3xs) var(--space-2xs);
   background: var(--accent-muted);
   border-radius: 3px;
-  font-size: 0.9rem;
+  font-size: var(--step--1);
 }
 
 .clear-filter:hover {
@@ -203,8 +203,8 @@
   display: flex;
   justify-content: center;
   align-items: center;
-  gap: 0.5rem;
-  padding: 1rem;
+  gap: var(--space-2xs);
+  padding: var(--space-s);
   list-style: none;
   margin: 0;
 }
@@ -215,11 +215,11 @@
   justify-content: center;
   min-width: 2.75rem;
   min-height: 2.75rem;
-  padding: 0 0.6rem;
+  padding: 0 var(--space-2xs);
   border: 1px solid var(--border-secondary);
   border-radius: 3px;
   color: var(--text-primary);
-  font-size: 0.99rem;
+  font-size: var(--step--1);
   text-decoration: none;
   transition: all 0.15s;
 }
@@ -236,9 +236,9 @@
 }
 
 .pagination-info {
-  font-size: 0.99rem;
+  font-size: var(--step--1);
   color: var(--text-secondary);
-  padding: 0 0.5rem;
+  padding: 0 var(--space-2xs);
 }
 
 .page-current {
diff --git a/public/assets/css/search.css b/public/assets/css/search.css
index 7a29cf6..37aff92 100644
--- a/public/assets/css/search.css
+++ b/public/assets/css/search.css
@@ -23,14 +23,14 @@
   display: grid;
   grid-template-columns: 0.7fr 1.2fr 1.4fr 0.9fr 1.4fr 1fr;
   gap: 0;
-  padding: 0 1.5rem;
+  padding: 0 var(--space-m);
   min-height: 100%;
 }
 
 @media (max-width: 1024px) {
   .repertoire-index {
     grid-template-columns: 1fr 1fr 1fr;
-    padding: 0 1rem;
+    padding: 0 var(--space-s);
     min-height: auto;
   }
 
@@ -47,14 +47,14 @@
 @media (max-width: 600px) {
   .repertoire-index {
     grid-template-columns: 1fr;
-    padding: 0 1rem;
+    padding: 0 var(--space-s);
     min-height: auto;
   }
 
   .repertoire-col {
     border-right: none;
     border-bottom: 1px solid var(--border-primary);
-    padding: 1rem 0 1.25rem;
+    padding: var(--space-s) 0 var(--space-m);
   }
 
   .repertoire-col:last-child {
@@ -63,7 +63,7 @@
 }
 
 .repertoire-col {
-  padding: 0.75rem 0.5rem 2rem;
+  padding: var(--space-xs) var(--space-2xs) var(--space-l);
   border-right: 1px solid var(--border-secondary);
 }
 
@@ -72,13 +72,13 @@
 }
 
 .repertoire-index section > h2 {
-  font-size: 0.79rem;
+  font-size: var(--step--2);
   letter-spacing: 0.1em;
   text-transform: uppercase;
   color: var(--text-secondary);
   font-weight: 400;
-  margin: 0 0 0.5rem 0;
-  padding-bottom: 0.4rem;
+  margin: 0 0 var(--space-2xs) 0;
+  padding-bottom: var(--space-3xs);
   border-bottom: 1px solid var(--border-secondary);
 }
 
@@ -96,10 +96,10 @@
   text-align: left;
   background: none;
   border: none;
-  padding: 0.1rem 0;
+  padding: var(--space-3xs) 0;
   margin: 0;
   font-family: inherit;
-  font-size: 1.04rem;
+  font-size: var(--step-0);
   color: var(--text-primary);
   line-height: 1.4;
   cursor: pointer;
@@ -130,18 +130,18 @@
 
 /* Years column — big bold numbers */
 .repertoire-col[data-col="years"] .rep-entry {
-  font-size: 2.42rem;
+  font-size: var(--step-3);
   font-weight: 700;
   line-height: 1.1;
   letter-spacing: -0.02em;
-  padding: 0.05rem 0;
+  padding: var(--space-3xs) 0;
 }
 
 /* Empty state in students column */
 .rep-empty {
   color: var(--text-tertiary);
-  font-size: 0.99rem;
-  padding: 0.1rem 0;
+  font-size: var(--step--1);
+  padding: var(--space-3xs) 0;
 }
 
 /* ---- HTMX loading indicator ---- */
@@ -173,18 +173,18 @@
 /* ---- Search results view (grid) ---- */
 .search-results-header {
   display: block;
-  font-size: 0.94rem;
+  font-size: var(--step--1);
   color: var(--text-secondary);
-  margin: 1rem 1.5rem 0.5rem;
+  margin: var(--space-s) var(--space-m) var(--space-2xs);
 }
 
 .results-grid {
   display: grid;
   grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
-  gap: 1.5rem;
+  gap: var(--space-m);
   list-style: none;
   margin: 0;
-  padding: 0.5rem 1.5rem 1.5rem;
+  padding: var(--space-2xs) var(--space-m) var(--space-m);
 }
 
 .result-card {
@@ -192,17 +192,17 @@
   color: inherit;
   display: flex;
   flex-direction: column;
-  gap: 0.4rem;
+  gap: var(--space-3xs);
 }
 
 .result-card__authors {
-  font-size: 0.99rem;
+  font-size: var(--step--1);
   font-weight: 500;
   color: var(--text-primary);
 }
 
 .result-card__title {
-  font-size: 0.94rem;
+  font-size: var(--step--1);
   color: var(--text-secondary);
   line-height: 1.35;
   display: -webkit-box;
@@ -212,7 +212,7 @@
 }
 
 .result-card__meta {
-  font-size: 0.86rem;
+  font-size: var(--step--2);
   color: var(--accent-primary);
   font-style: normal;
 }
@@ -221,8 +221,8 @@
 .search-controls {
   display: flex;
   align-items: center;
-  gap: 1rem;
-  padding: 0.4rem 1.5rem;
+  gap: var(--space-s);
+  padding: var(--space-3xs) var(--space-m);
   border-bottom: 1px solid var(--border-secondary);
   flex-shrink: 0;
   flex-wrap: wrap;
@@ -231,8 +231,8 @@
 .search-filter-label {
   display: flex;
   align-items: center;
-  gap: 0.4rem;
-  font-size: 0.86rem;
+  gap: var(--space-3xs);
+  font-size: var(--step--2);
   color: var(--text-secondary);
   text-transform: uppercase;
   letter-spacing: 0.06em;
@@ -241,10 +241,10 @@
 }
 
 .search-filter-select {
-  font-size: 0.9rem;
+  font-size: var(--step--1);
   border: 1px solid var(--border-primary);
   border-radius: 3px;
-  padding: 0.2rem 0.5rem;
+  padding: var(--space-3xs) var(--space-2xs);
   background: var(--bg-primary);
   color: var(--text-primary);
   font-family: inherit;
@@ -256,8 +256,8 @@
 }
 
 .search-apply-btn {
-  font-size: 0.9rem;
-  padding: 0.2rem 0.8rem;
+  font-size: var(--step--1);
+  padding: var(--space-3xs) var(--space-xs);
   background: var(--accent-primary);
   color: var(--accent-foreground);
   border: none;
@@ -272,7 +272,7 @@
 }
 
 .search-reset-link {
-  font-size: 0.9rem;
+  font-size: var(--step--1);
   color: var(--text-secondary);
   text-decoration: underline;
   cursor: pointer;
@@ -283,8 +283,8 @@
   display: flex;
   justify-content: center;
   align-items: center;
-  gap: 0.5rem;
-  padding: 1.5rem 0;
+  gap: var(--space-2xs);
+  padding: var(--space-m) 0;
 }
 
 .pagination-btn {
@@ -293,11 +293,11 @@
   justify-content: center;
   min-width: 2.75rem;
   min-height: 2.75rem;
-  padding: 0 0.6rem;
+  padding: 0 var(--space-2xs);
   border: 1px solid var(--border-secondary);
   border-radius: 3px;
   color: var(--text-primary);
-  font-size: 0.99rem;
+  font-size: var(--step--1);
   text-decoration: none;
   transition: all 0.15s;
 }
@@ -314,15 +314,15 @@
 }
 
 .pagination-info {
-  font-size: 0.99rem;
+  font-size: var(--step--1);
   color: var(--text-secondary);
-  padding: 0 0.5rem;
+  padding: 0 var(--space-2xs);
 }
 
 .search-empty {
-  padding: 3rem 1.5rem;
+  padding: var(--space-xl) var(--space-m);
   color: var(--text-secondary);
-  font-size: 1.1rem;
+  font-size: var(--step-0);
   text-align: center;
 }
 
@@ -331,8 +331,8 @@
   background: var(--search-error-bg);
   border-left: 3px solid var(--search-error-border);
   color: var(--search-error-color);
-  padding: 0.5rem 1rem;
-  font-size: 0.97rem;
-  margin: 0.5rem 1.5rem;
+  padding: var(--space-2xs) var(--space-s);
+  font-size: var(--step--1);
+  margin: var(--space-2xs) var(--space-m);
   flex-shrink: 0;
 }
diff --git a/public/assets/css/system.css b/public/assets/css/system.css
index 31ee778..eb1083d 100644
--- a/public/assets/css/system.css
+++ b/public/assets/css/system.css
@@ -9,12 +9,12 @@
     display: flex;
     gap: 0;
     border-bottom: 1px solid var(--sys-border);
-    margin-bottom: 1.75rem;
+    margin-bottom: var(--space-m);
 }
 .sys-tab {
     display: inline-block;
-    padding: .55rem 1.1rem;
-    font-size: 0.92rem;
+    padding: var(--space-3xs) var(--space-s);
+    font-size: var(--step--1);
     font-weight: 500;
     color: var(--sys-text-dim);
     text-decoration: none;
@@ -35,23 +35,23 @@
     background: var(--sys-bg-panel);
     border: 1px solid var(--sys-border);
     border-radius: 6px;
-    padding: 1rem 1.25rem 1.25rem;
-    margin-bottom: 1.75rem;
+    padding: var(--space-s) var(--space-m);
+    margin-bottom: var(--space-m);
 }
 .sys-status-header {
     display: flex;
     align-items: center;
     justify-content: space-between;
-    margin-bottom: 1rem;
+    margin-bottom: var(--space-s);
 }
 .sys-status-toggle {
     background: none;
     border: 1px solid var(--sys-border);
     color: var(--sys-text-dim);
     border-radius: 3px;
-    font-size: 0.79rem;
+    font-size: var(--step--2);
     font-family: inherit;
-    padding: .2rem .55rem;
+    padding: var(--space-3xs) var(--space-2xs);
     cursor: pointer;
     white-space: nowrap;
     transition: color .15s, border-color .15s;
@@ -63,9 +63,9 @@
 .sys-status-meta {
     display: grid;
     grid-template-columns: 1fr 1fr;
-    gap: 1.5rem 2rem;
-    margin-top: 1.5rem;
-    padding-top: 1.25rem;
+    gap: var(--space-m) var(--space-l);
+    margin-top: var(--space-m);
+    padding-top: var(--space-m);
     border-top: 1px solid var(--sys-border-deep);
 }
 @media (max-width: 700px) {
@@ -76,47 +76,47 @@
 .srv-grid {
     display: grid;
     grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
-    gap: 1rem;
-    margin-bottom: 2.5rem;
+    gap: var(--space-s);
+    margin-bottom: var(--space-l);
 }
 .srv-card {
     background: var(--sys-bg-surface);
     border: 1px solid var(--sys-border);
     border-radius: 5px;
-    padding: 1rem 1.25rem;
+    padding: var(--space-s) var(--space-m);
 }
 .srv-card__header {
     display: flex;
     align-items: center;
     justify-content: space-between;
-    margin-bottom: .4rem;
+    margin-bottom: var(--space-3xs);
 }
 .srv-card__name {
-    font-size: 0.9rem;
+    font-size: var(--step--1);
     text-transform: uppercase;
     letter-spacing: .07em;
     color: var(--sys-text-dim);
     font-weight: 500;
 }
 .srv-card__detail {
-    font-size: 0.88rem;
+    font-size: var(--step--2);
     color: var(--sys-text-dim);
-    margin-top: .25rem;
+    margin-top: var(--space-3xs);
     font-family: ui-monospace, "SFMono-Regular", Consolas, monospace;
 }
-.status-ok      { color: var(--accent-green);   font-weight: 600; font-size: 0.94rem; }
-.status-warn    { color: var(--warning);         font-weight: 600; font-size: 0.94rem; }
-.status-err     { color: var(--error);           font-weight: 600; font-size: 0.94rem; }
-.status-unknown { color: var(--text-tertiary);   font-weight: 600; font-size: 0.94rem; }
+.status-ok      { color: var(--accent-green);   font-weight: 600; font-size: var(--step--1); }
+.status-warn    { color: var(--warning);         font-weight: 600; font-size: var(--step--1); }
+.status-err     { color: var(--error);           font-weight: 600; font-size: var(--step--1); }
+.status-unknown { color: var(--text-tertiary);   font-weight: 600; font-size: var(--step--1); }
 
 .srv-section-title {
-    font-size: 0.9rem;
+    font-size: var(--step--1);
     text-transform: uppercase;
     letter-spacing: .1em;
     color: var(--sys-text-dim);
     border-bottom: 1px solid var(--sys-border);
-    padding-bottom: .4rem;
-    margin: 0 0 1rem;
+    padding-bottom: var(--space-3xs);
+    margin: 0 0 var(--space-s);
     font-weight: 500;
 }
 /* Compact variant: no border, no margin — used inside sys-status-header */
@@ -126,14 +126,14 @@
     padding: 0;
 }
 /* Sub-section variant: tighter bottom margin — used for PHP/disk sub-headings */
-.srv-section-title--sub { margin-bottom: .75rem; }
+.srv-section-title--sub { margin-bottom: var(--space-xs); }
 
 /* ── PHP info grid ─────────────────────────────────────────────────────── */
 .php-grid {
     display: grid;
     grid-template-columns: repeat(auto-fill, minmax(180px, 1fr));
-    gap: .5rem .75rem;
-    margin-bottom: 2.5rem;
+    gap: var(--space-3xs) var(--space-xs);
+    margin-bottom: var(--space-l);
 }
 /* Flush variant: no bottom margin — used inside sys-status-meta cell */
 .php-grid--flush { margin-bottom: 0; }
@@ -141,19 +141,19 @@
     background: var(--sys-bg-surface);
     border: 1px solid var(--sys-border);
     border-radius: 4px;
-    padding: .5rem .75rem;
+    padding: var(--space-3xs) var(--space-xs);
 }
 .php-item__key {
-    font-size: 0.83rem;
+    font-size: var(--step--2);
     text-transform: uppercase;
     letter-spacing: .06em;
     color: var(--sys-text-dim);
 }
 .php-item__val {
-    font-size: 1.01rem;
+    font-size: var(--step--1);
     font-family: ui-monospace, "SFMono-Regular", Consolas, monospace;
     color: var(--sys-text-bright);
-    margin-top: .15rem;
+    margin-top: var(--space-3xs);
 }
 
 /* ── Disk bar ──────────────────────────────────────────────────────────── */
@@ -161,13 +161,12 @@
     background: var(--sys-border);
     border-radius: 3px;
     height: 6px;
-    margin-top: .5rem;
+    margin-top: var(--space-2xs);
     overflow: hidden;
 }
 .disk-bar {
     height: 100%;
     border-radius: 3px;
-    /* width and color driven by PHP via --disk-pct and --disk-color inline vars */
     width: var(--disk-pct, 0%);
     background: var(--disk-color, var(--accent-green));
     transition: width .3s;
@@ -175,14 +174,14 @@
 .disk-stats {
     display: flex;
     justify-content: space-between;
-    font-size: 0.86rem;
+    font-size: var(--step--2);
     color: var(--sys-text-dim);
-    margin-top: .25rem;
+    margin-top: var(--space-3xs);
 }
 
 /* ── Tab panel loading state ───────────────────────────────────────────── */
 #sys-tab-panel {
-    min-height: 8rem;  /* prevent layout jump while fetching */
+    min-height: 8rem;
     position: relative;
 }
 #sys-tab-panel.sys-panel-loading {
@@ -215,11 +214,11 @@
     display: flex;
     flex-wrap: wrap;
     align-items: center;
-    gap: .6rem;
-    margin-bottom: 1.25rem;
+    gap: var(--space-2xs);
+    margin-bottom: var(--space-m);
 }
 .log-toolbar label {
-    font-size: 0.92rem;
+    font-size: var(--step--1);
     color: var(--text-secondary);
 }
 .log-toolbar select {
@@ -227,19 +226,19 @@
     border: 1px solid var(--sys-border);
     color: var(--sys-text-bright);
     border-radius: 4px;
-    padding: .4rem .7rem;
-    font-size: 0.94rem;
+    padding: var(--space-3xs) var(--space-xs);
+    font-size: var(--step--1);
     font-family: inherit;
 }
 .log-toolbar select:focus { outline: 2px solid var(--accent-primary); }
 
 .log-meta {
-    font-size: 0.86rem;
+    font-size: var(--step--2);
     color: var(--sys-text-dim);
     font-family: ui-monospace, "SFMono-Regular", Consolas, monospace;
-    margin-bottom: .75rem;
+    margin-bottom: var(--space-xs);
     display: flex;
-    gap: 1.5rem;
+    gap: var(--space-m);
     flex-wrap: wrap;
 }
 .log-meta span::before { content: attr(data-label) ": "; opacity: .6; }
@@ -248,34 +247,34 @@
     background: var(--sys-bg-surface);
     border: 1px solid var(--sys-border);
     border-radius: 4px;
-    padding: 1.5rem;
+    padding: var(--space-m);
     color: var(--sys-text-dim);
-    font-size: 0.97rem;
+    font-size: var(--step--1);
 }
 .log-unavail-path {
     font-family: ui-monospace, "SFMono-Regular", Consolas, monospace;
-    font-size: 0.88rem;
-    margin-top: .4rem;
+    font-size: var(--step--2);
+    margin-top: var(--space-3xs);
     opacity: .7;
 }
 .log-unavail-dev {
-    margin-top: .6rem;
-    font-size: 0.88rem;
+    margin-top: var(--space-2xs);
+    font-size: var(--step--2);
     opacity: .7;
 }
 .log-empty {
     color: var(--sys-text-dim);
-    font-size: 0.97rem;
-    padding: 1rem 0;
+    font-size: var(--step--1);
+    padding: var(--space-s) 0;
 }
 .log-output {
     background: var(--sys-bg-deep);
     border: 1px solid var(--sys-border);
     border-radius: 4px;
-    padding: 1rem;
+    padding: var(--space-s);
     overflow-x: auto;
     font-family: ui-monospace, "SFMono-Regular", Consolas, "Courier New", monospace;
-    font-size: 0.84rem;
+    font-size: var(--step--2);
     line-height: 1.55;
     max-height: 62vh;
     overflow-y: auto;
@@ -284,7 +283,7 @@
 .log-line {
     display: block;
     white-space: pre;
-    padding: .05rem .1rem;
+    padding: var(--space-3xs) var(--space-3xs);
     border-radius: 2px;
     color: var(--sys-text-body);
 }
@@ -297,7 +296,7 @@
     content: attr(data-n);
     display: inline-block;
     min-width: 4ch;
-    margin-right: .75rem;
+    margin-right: var(--space-xs);
     opacity: .3;
     text-align: right;
     user-select: none;
@@ -306,21 +305,21 @@
     background: var(--sys-bg-surface);
     border: 1px solid var(--sys-border);
     border-radius: 3px;
-    font-size: 0.84rem;
-    padding: .15rem .5rem;
+    font-size: var(--step--2);
+    padding: var(--space-3xs) var(--space-2xs);
     color: var(--sys-text-dim);
     font-family: ui-monospace, monospace;
 }
 .log-copy-btn {
     position: absolute;
-    top: .6rem;
-    right: .6rem;
+    top: var(--space-2xs);
+    right: var(--space-2xs);
     background: var(--sys-bg-surface);
     border: 1px solid var(--sys-border);
     color: var(--sys-text-dim);
     border-radius: 4px;
-    font-size: 0.84rem;
-    padding: .25rem .6rem;
+    font-size: var(--step--2);
+    padding: var(--space-3xs) var(--space-2xs);
     cursor: pointer;
     font-family: inherit;
     transition: color .15s, border-color .15s;
@@ -336,9 +335,9 @@
 }
 
 .sys-refresh-note {
-    font-size: 0.86rem;
+    font-size: var(--step--2);
     color: var(--sys-text-dim);
-    margin-bottom: 1.25rem;
+    margin-bottom: var(--space-m);
 }
 .sys-refresh-note a {
     color: var(--accent-primary);
@@ -349,12 +348,12 @@
 /* ── Cache freshness badges ────────────────────────────────────────────── */
 .sys-cache-badge {
     display: inline-block;
-    font-size: 0.75rem;
+    font-size: var(--step--2);
     font-weight: 400;
     font-family: ui-monospace, monospace;
-    padding: .1rem .45rem;
+    padding: var(--space-3xs) var(--space-3xs);
     border-radius: 3px;
-    margin-left: .7rem;
+    margin-left: var(--space-xs);
     vertical-align: middle;
     line-height: 1.6;
 }
@@ -372,11 +371,11 @@
 /* ── Nginx config viewer ───────────────────────────────────────────────── */
 .nginx-source-badge {
     display: inline-block;
-    font-size: 0.79rem;
+    font-size: var(--step--2);
     font-family: ui-monospace, monospace;
-    padding: .15rem .55rem;
+    padding: var(--space-3xs) var(--space-2xs);
     border-radius: 3px;
-    margin-left: .6rem;
+    margin-left: var(--space-2xs);
     vertical-align: middle;
 }
 .nginx-source-badge--live {
diff --git a/public/assets/css/tfe.css b/public/assets/css/tfe.css
index 904f46f..3ccb3e2 100644
--- a/public/assets/css/tfe.css
+++ b/public/assets/css/tfe.css
@@ -13,14 +13,14 @@
 
 .tfe-main {
   flex: 1;
-  padding: 2rem 1.5rem 3rem;
+  padding: var(--space-l) var(--space-m) var(--space-xl);
 }
 
 /* Two-column article layout */
 .tfe-layout {
   display: grid;
   grid-template-columns: 1fr 1.4fr;
-  gap: 3rem;
+  gap: var(--space-xl);
   width: 100%;
   max-width: 1200px;
   align-items: start;
@@ -30,13 +30,13 @@
 .tfe-left {
   display: flex;
   flex-direction: column;
-  gap: 1.5rem;
+  gap: var(--space-m);
 }
 
 /* Author (p) — above title */
 .tfe-author {
   font-family: var(--font-display);
-  font-size: 1.54rem;
+  font-size: var(--step-1);
   font-weight: 400;
   color: var(--text-primary);
   margin: 0;
@@ -46,7 +46,7 @@
 /* Title (h1) — primary heading, very large */
 .tfe-title {
   font-family: var(--font-display);
-  font-size: 2.42rem;
+  font-size: var(--step-3);
   font-weight: 400;
   color: var(--text-primary);
   margin: 0;
@@ -58,8 +58,8 @@
 article dl {
   display: flex;
   flex-direction: column;
-  gap: 0.45rem;
-  font-size: 1.04rem;
+  gap: var(--space-3xs);
+  font-size: var(--step--1);
   line-height: 1.4;
   margin: 0;
 }
@@ -67,7 +67,7 @@ article dl {
 /* Each dt/dd pair grouped in a <div> inside <dl> */
 article dl > div {
   display: flex;
-  gap: 0.4rem;
+  gap: var(--space-3xs);
   flex-wrap: wrap;
 }
 
@@ -100,7 +100,7 @@ article dl dd a {
 
 /* Synopsis paragraph */
 .tfe-synopsis-text {
-  font-size: 1.04rem;
+  font-size: var(--step--1);
   line-height: 1.7;
   color: var(--text-primary);
   margin: 0;
@@ -110,7 +110,7 @@ article dl dd a {
 .tfe-right {
   display: flex;
   flex-direction: column;
-  gap: 1.5rem;
+  gap: var(--space-m);
 }
 
 /* Each file display unit — target <figure> directly inside <aside> */
@@ -144,16 +144,16 @@ aside figure embed {
 
 /* figcaption under media — target <figcaption> inside <aside> */
 aside figcaption {
-  font-size: 0.88rem;
+  font-size: var(--step--2);
   color: var(--text-secondary);
-  margin: 0.3rem 0 0;
+  margin: var(--space-3xs) 0 0;
   font-style: italic;
 }
 
 /* PDF fallback download link */
 .tfe-pdf-fallback {
-  font-size: 0.94rem;
-  margin: 0.4rem 0 0;
+  font-size: var(--step--1);
+  margin: var(--space-3xs) 0 0;
 }
 
 .tfe-pdf-fallback a {
@@ -165,10 +165,10 @@ aside figcaption {
 /* "Not available" and "no files" notices */
 .tfe-restricted,
 .tfe-no-files {
-  font-size: 1.04rem;
+  font-size: var(--step--1);
   color: var(--text-secondary);
   font-style: italic;
-  padding: 1rem 0;
+  padding: var(--space-s) 0;
   margin: 0;
 }
 
@@ -176,20 +176,20 @@ aside figcaption {
 @media (max-width: 900px) {
   .tfe-layout {
     grid-template-columns: 1fr;
-    gap: 2rem;
+    gap: var(--space-l);
   }
 
   .tfe-title {
-    font-size: 1.87rem;
+    font-size: var(--step-2);
   }
 }
 
 @media (max-width: 600px) {
   .tfe-main {
-    padding: 1.5rem 1rem 2rem;
+    padding: var(--space-m) var(--space-s) var(--space-l);
   }
 
   .tfe-title {
-    font-size: 1.54rem;
+    font-size: var(--step-1);
   }
 }
diff --git a/public/assets/css/variables.css b/public/assets/css/variables.css
index ac9c35e..f7f2dc5 100644
--- a/public/assets/css/variables.css
+++ b/public/assets/css/variables.css
@@ -2,6 +2,44 @@
    CSS VARIABLES (CUSTOM PROPERTIES)
    ============================================================ */
 
+/* @link https://utopia.fyi/type/calculator?c=360,18,1.2,1240,20,1.25,5,2,&s=0.75|0.5|0.25,1.5|2|3|4|6,s-l&g=s,l,xl,12 */
+:root {
+  --step--2: clamp(0.7813rem, 0.7736rem + 0.0341vw, 0.8rem);
+  --step--1: clamp(0.9375rem, 0.9119rem + 0.1136vw, 1rem);
+  --step-0:  clamp(1.125rem,  1.0739rem + 0.2273vw, 1.25rem);
+  --step-1:  clamp(1.35rem,   1.2631rem + 0.3864vw, 1.5625rem);
+  --step-2:  clamp(1.62rem,   1.4837rem + 0.6057vw, 1.9531rem);
+  --step-3:  clamp(1.944rem,  1.7405rem + 0.9044vw, 2.4414rem);
+  --step-4:  clamp(2.3328rem, 2.0387rem + 1.3072vw, 3.0518rem);
+  --step-5:  clamp(2.7994rem, 2.384rem  + 1.8461vw, 3.8147rem);
+}
+
+/* @link https://utopia.fyi/space/calculator?c=360,18,1.2,1240,20,1.25,5,2,&s=0.75|0.5|0.25,1.5|2|3|4|6,s-l&g=s,l,xl,12 */
+:root {
+  --space-3xs: clamp(0.3125rem, 0.3125rem + 0vw,      0.3125rem);
+  --space-2xs: clamp(0.5625rem, 0.5369rem + 0.1136vw, 0.625rem);
+  --space-xs:  clamp(0.875rem,  0.8494rem + 0.1136vw, 0.9375rem);
+  --space-s:   clamp(1.125rem,  1.0739rem + 0.2273vw, 1.25rem);
+  --space-m:   clamp(1.6875rem, 1.6108rem + 0.3409vw, 1.875rem);
+  --space-l:   clamp(2.25rem,   2.1477rem + 0.4545vw, 2.5rem);
+  --space-xl:  clamp(3.375rem,  3.2216rem + 0.6818vw, 3.75rem);
+  --space-2xl: clamp(4.5rem,    4.2955rem + 0.9091vw, 5rem);
+  --space-3xl: clamp(6.75rem,   6.4432rem + 1.3636vw, 7.5rem);
+
+  /* One-up pairs */
+  --space-3xs-2xs: clamp(0.3125rem, 0.1847rem + 0.5682vw, 0.625rem);
+  --space-2xs-xs:  clamp(0.5625rem, 0.4091rem + 0.6818vw, 0.9375rem);
+  --space-xs-s:    clamp(0.875rem,  0.7216rem + 0.6818vw, 1.25rem);
+  --space-s-m:     clamp(1.125rem,  0.8182rem + 1.3636vw, 1.875rem);
+  --space-m-l:     clamp(1.6875rem, 1.3551rem + 1.4773vw, 2.5rem);
+  --space-l-xl:    clamp(2.25rem,   1.6364rem + 2.7273vw, 3.75rem);
+  --space-xl-2xl:  clamp(3.375rem,  2.7102rem + 2.9545vw, 5rem);
+  --space-2xl-3xl: clamp(4.5rem,    3.2727rem + 5.4545vw, 7.5rem);
+
+  /* Custom pairs */
+  --space-s-l: clamp(1.125rem, 0.5625rem + 2.5vw, 2.5rem);
+}
+
 :root {
   /* Fonts */
   --font-body:    "BBBDMSans", sans-serif;