465eb05aaf
twenty-website had accumulated structural problems that were cheaper to fix by rebuilding than to refactor in place: - Drift had no guardrails. Values were matched at call sites instead of single-sourced, so things silently diverged — e.g. the radius token base was wrong for days (every radius() consumer rendered double) because nothing measured it against the old site's CSS variables. - A whole tree escaped quality checks. src/lib/ (~9.8k lines) was never format-checked, because oxfmt silently ignores directories named lib/. - Inconsistent rhythm. Hero spacing varied 24–88px between pages (CEO-flagged), because section spacing wasn't a token. - Over-extraction. -config.ts sprawl pulled single-component configuration out into the wrong place. The goal: a ground-up rebuild where drift is structurally impossible, held to a Linear / Railway / Notion / Attio quality bar. The old site is treated as source of intent only — nothing is blindly ported; every piece is re-decided and A/B-verified. **Rebuild** A full rebuild on Next 16 + Turbopack + Linaria (zero-runtime CSS), ~1,100 files. Marketing pages (home, product, pricing, partners + marketplace, customers/case-studies, why-twenty, releases, legal), the interactive AppPreview product mockup, the platform/visuals WebGL system (engine + rigs, three code-split off every initial chunk), and the standalone /halftone studio (the dev tool that generates the site's halftone art — engine, exporters, and full UI ported as an isolated island). **Architecture & guarantees** - Parity by construction. src/tokens/definitions.ts is the only file with raw values; the :root CSS-variable block is generated from it at build time and accessors derive var names through the same helpers — derived alpha tokens appear in served CSS without ever being hand-written. - Mobile-first by API shape. mediaUp() is the only media helper (no max-width helper exists, on purpose). - Section rhythm is a token (RHYTHM.section) — the hero-spacing inconsistency class is fixed by construction. - Fluid type ramps interpolate font-size and line-height between designed endpoints [390px → md]; TYPE_SCALE is the single source. - three.js never enters an initial chunk — confined to platform/visuals heavy zones, reached only via dynamic(ssr:false), enforced by check-visual-bundle.
104 lines
3.1 KiB
JavaScript
104 lines
3.1 KiB
JavaScript
import { readFileSync } from 'node:fs';
|
|
|
|
import {
|
|
createBattery,
|
|
launchBrowser,
|
|
NEW_BASE,
|
|
openPage,
|
|
} from './battery-kit.mjs';
|
|
|
|
// Decorative section backgrounds (gradients, halftones, notched cards,
|
|
// crosshairs) must never bleed past the content column — only the section's
|
|
// solid colour is full-bleed. The cap is read from the token itself, so this
|
|
// guard can never drift from it. Measured well past the cap so the centring is
|
|
// exercised: every [data-background-layer] must land <= the cap and centred.
|
|
const tokenSource = readFileSync(
|
|
new URL('../src/tokens/max-content-width.ts', import.meta.url),
|
|
'utf8',
|
|
);
|
|
const MAX_CONTENT_WIDTH_PX = Number(
|
|
/MAX_CONTENT_WIDTH_PX\s*=\s*(\d+)/.exec(tokenSource)?.[1],
|
|
);
|
|
const WIDE_VIEWPORT = { height: 1200, width: 2400 };
|
|
const PAGES = [
|
|
'/',
|
|
'/product',
|
|
'/pricing',
|
|
'/customers',
|
|
'/partners',
|
|
'/why-twenty',
|
|
'/releases',
|
|
];
|
|
|
|
const battery = createBattery('background-cap');
|
|
const browser = await launchBrowser();
|
|
|
|
for (const pagePath of PAGES) {
|
|
// eslint-disable-next-line no-await-in-loop
|
|
const page = await openPage(browser, `${NEW_BASE}${pagePath}`, {
|
|
settleMs: 1000,
|
|
viewport: WIDE_VIEWPORT,
|
|
});
|
|
|
|
// eslint-disable-next-line no-await-in-loop
|
|
const pageHeight = await page.evaluate(
|
|
() => document.documentElement.scrollHeight,
|
|
);
|
|
for (let y = 0; y <= pageHeight; y += 800) {
|
|
// eslint-disable-next-line no-await-in-loop
|
|
await page.evaluate((scrollY) => window.scrollTo(0, scrollY), y);
|
|
// eslint-disable-next-line no-await-in-loop
|
|
await page.waitForTimeout(150);
|
|
}
|
|
|
|
// eslint-disable-next-line no-await-in-loop
|
|
const layers = await page.evaluate(() =>
|
|
[...document.querySelectorAll('[data-background-layer]')]
|
|
.map((element) => element.getBoundingClientRect())
|
|
.filter((rect) => rect.width > 0)
|
|
.map((rect) => ({
|
|
leftMargin: Math.round(rect.left),
|
|
rightMargin: Math.round(window.innerWidth - rect.right),
|
|
width: Math.round(rect.width),
|
|
})),
|
|
);
|
|
// eslint-disable-next-line no-await-in-loop
|
|
await page.close();
|
|
|
|
if (layers.length === 0) {
|
|
battery.ok(`${pagePath} — no capped background layers rendered`, 'none');
|
|
continue;
|
|
}
|
|
|
|
const overflowing = layers.filter(
|
|
(layer) => layer.width > MAX_CONTENT_WIDTH_PX + 1,
|
|
);
|
|
const offCentre = layers.filter(
|
|
(layer) => Math.abs(layer.leftMargin - layer.rightMargin) > 2,
|
|
);
|
|
|
|
if (overflowing.length > 0) {
|
|
battery.fail(
|
|
`${pagePath} background layers exceed ${MAX_CONTENT_WIDTH_PX}px`,
|
|
JSON.stringify(overflowing),
|
|
);
|
|
}
|
|
if (offCentre.length > 0) {
|
|
battery.fail(
|
|
`${pagePath} background layers not centred`,
|
|
JSON.stringify(offCentre),
|
|
);
|
|
}
|
|
if (overflowing.length === 0 && offCentre.length === 0) {
|
|
const widths = [...new Set(layers.map((layer) => layer.width))].toSorted(
|
|
(first, second) => second - first,
|
|
);
|
|
battery.ok(
|
|
`${pagePath} — ${layers.length} background layers capped + centred`,
|
|
`widths ${widths.join(', ')}px <= ${MAX_CONTENT_WIDTH_PX}`,
|
|
);
|
|
}
|
|
}
|
|
|
|
await battery.finish(browser);
|