← Back to the screen

Design system portfolio

Design record: Verrazzano Stone

The four direction lines behind this page, the generator command that produced its tokens, and the pairs it was measured against.

A stone importer's trade catalog: ten slabs on the racks at two New Jersey yards, browsed by facet, and then one slab's specification page.

Direction

LeverDecision
ArchetypeIndex, faceted. A sticky rail of native checkbox facets against one list that takes the rest of the width.
Data stanceTable-first. The slab inventory table is the product, and the photograph is a column in it rather than an illustration beside it.
DensityDefault. --mc-space-md inside a row, --mc-space-xl between groups, --mc-space-3xl between sections.
The one bold thingStock carries the minute it was counted, and the minutes differ by row. No specimen frame holds anything but the material. A sold slab keeps its page and routes to the two sequential cuts behind it.

Why this product suits this system

material-catalog is the only system here written for a business whose product is a physical object photographed under one lighting setup, and whose photograph is a claim somebody can send back on a truck. Its non-negotiables are all about not getting in the way of that: a fixed neutral surround identical in both themes, no radius on a specimen, no tint over a material, and a scale solver that decides how wide an image has to be before a 4 mm vein exists in it.

A slab yard pushes every one of those. Each slab is unique, so the index cannot be a grid of one hero shot per material; stock goes stale in hours, so a figure with no timestamp is a lie; and the buyer's four questions (finish, thickness, slab dimensions, lot) are exactly what a table answers and a card does not.

Generator

mat_tokens.py --both > tokens.css

The brief recorded mat_tokens.py with no flag, which emits light only. --both was run instead so the page can meet CONTRACT.md §5 on themes; its :root block is byte-identical to the flagless output, and the flag adds [data-theme="light"], [data-theme="dark"] and a prefers-color-scheme block. The generator's own --self-test holds the specimen tokens identical across the two themes, which is the reason a dark rail beside a light specimen grid is legitimate here.

The scale, solved rather than chosen

mat_tokens.py --scale

Deviations from CONTRACT.md

  1. §2, images. Photographs are image files under img/ (AVIF for the whole-slab and large detail images, WebP for the table plates) rather than inline data: URIs. Base64 inside the document would add roughly a third to about 1.1 MB of imagery and put it all in front of the first paint on a page whose subject is a photograph. Every <img> still carries explicit width, height and a real alt.
  2. §1, tokens. tokens.css was regenerated with --both rather than patched. See the Generator section.

The uplift

What changed, in the order a visitor meets it, and why.

Two choices that depart from the first brief. Studio pieces are drawn as outline boxes over the photograph, in a layer that is not inside the specimen frame, so the frame still holds nothing but the material. The page's date is Friday 11 September 2026, 09:15, and every as-of time agrees with it.

Gates

catalog_lint.py, audit_page.py, slop_scan.py, craft_lint.py, motion_lint.py, layout_lint.py, copy_lint.py, direction_check.py, contrast.py and aria_lint.py. Output is in the handover.

Round four

Round eight

Round nine

Method: a fabricator's buyer in a browser (filter the yard, pick a slab, compare, place a hold, lay out a job), then real-phone emulation at 390 and 360, 200% zoom, dark mode and a keyboard pass. Figures checked against each other: gross areas sum to 46.13 m², less the sold 4.74 m² gives 41.39 m² on the racks; 8 of 10 serials available; every weight equals density x length x width x thickness.

Round ten

A second, colder read as a fabricator's buyer placing a hold on a one-of-a-kind slab. Score on the ten heuristics, 27 before and 32 after; user control and freedom was 1 (the hold had no way back on the page), error prevention 2 and help 2 (the hold's end time and cost sat only inside the form).

No copy-lint.ignore exists for this page, so there was no comment to check.

Inventions, named because the brief gives no rule for them: a hold ends by itself at its end time and the slab goes back on sale; releasing is immediate and unrestored; "Nobody rings you; the confirmation is emailed" and "to keep it longer, ring the yard"; a released slab reads "Released 09:15 today" (the page's own time); leaving the queue closes its reference.

Round eleven (2026-11-10)

An independent reviewer found that "Turn piece" in the layout studio dropped the Slabs figure from 2 to 1 and left "Request a quote for this layout" enabled for a layout that cannot be cut (severity 2).

Round thirteen (2026-11-10)

An independent reviewer found that choosing a slab in the list scrolled the page back up to the viewing bay, so a reader comparing three rows lost their place each time (consistency, severity 2 in effect).

Round fifteen (2026-11-10)

An independent reviewer found that a search with no match showed nothing near the box (severity 2): typing "zzzz" and pressing Enter left the viewport unchanged, and the answer, "Nothing in the yard answers to zzzz", sat about 1,000 px below the pinned header.

Round seventeen (2026-11-10)

An independent reviewer reserved two things: after choosing a slab at 1440 the sticky "In the bay" bar covered the first line of the table caption "Slab inventory, Newark and Bayonne" mid-scroll (severity 1), and the hold dialog said "Nobody rings you" and "ring the Newark yard" in one table (severity 1).

Round nineteen (2026-11-10)

Ship note from the independent score of round eighteen (36/40): at 1920 the hero's left edge (240) and the list column's (272) stepped by 32 px.

Inventions: none.