Files
twenty/packages/twenty-website-redone/scripts/background-cap.mjs
T
Abdullah. 465eb05aaf Reworked website. (#21763)
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.
2026-06-18 11:55:24 +02:00

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);