5.6 Sol's performance pass

A morning review produced a long list of ways to make this site faster. The useful part was not a rewrite: it was moving bytes out of first paint, giving every cacheable thing a stable identity, and making the deploy fail before a regression reaches the edge.

This page is the shop card for that pass. “5.6 Sol” is the reviewer; the evidence is the code, the build gate, and the Chrome trace below. No benchmark theatre, no invented p75.

first paintimmutable bytesdeploy gatefield p75 pending
01

Clear first paint

Static desktop markup, a tiny critical shell, native fonts, and no render-blocking JavaScript. The page can look like itself before the deferred nav arrives.

02

Give bytes a name

Hashed thumbnails, honest 404s, edge-direct assets, and cache keys that change when bytes change. A cache hit is only useful when it is the right file.

03

Make shipping fail loud

Build-time invariants, minified shell budgets, readable source twins, and a route oracle. The fast path includes proving that the fast path shipped.

performance workbench / three checks

CHECK 01 · FIRST PAINT

Pick a layer of the tune-up. The readout is deliberately small: one concrete decision, one thing to measure, one thing that can still go wrong.

Make the first frame honest

Keep the desktop and window geometry in the document, preload the shared Luna sheet, and defer the shell behavior. The browser paints the identity before JavaScript has had a chance to help.

count4
signal0.00
prooftrace

What actually made it onto the lift

briefgarage translation
shell + CSSluna.css is one shared, cacheable sheet; the desktop shell is static markup; nav.js stays deferred and ships minified with a readable twin.
photo bytesThumbnails are content-addressed and immutable; the first homepage slot is the designed LCP, with dimensions reserved and the rest lazy.
edge workStatic assets answer directly; Worker routes are explicit; KV-backed work uses stale-while-revalidate instead of holding the document hostage.
proof before deployThe build parses CSS, checks the route mirror, caps the gzip bundle, and keeps /*.src.* twins so performance never costs View Source.
The honesty rule: 136ms LCP and 0.00 CLS are from a local, unthrottled Chrome trace of this page—not field p75. The next useful measurement is a cold, slow-4G run against production, then a real-device check. A plan is not a result until the browser agrees.

The long-form design ledger lives in Blueprint; the byte-level history is in Bytes on the wire. Back to the garage.

performance field notelocal Chrome traceno API callsadded 2026-07-10