Cross-border freight: 140 open consignments, their customs status, and the ones that have stopped.
Direction
| Lever | Decision |
|---|---|
| Archetype | Shell. Ant Layout.Sider at 208px, collapsing to a 64px icon rail under 992px; one scroll region for the table. |
| Data stance | Table-first at maximum density. Fourteen columns, the checkbox and the reference frozen, the horizontal scroll held inside the table. Filters live in the column headers. |
| Density | Ant small: 8px cell padding on 14px text, 43px rows measured, 24px header controls, 32px page controls. |
| The bold thing | An exception is a sentence, not a colour. The row keeps its own background and gains a second line naming what stopped it. That sentence is sticky: past the frozen columns on a desktop, and at the left edge of the scroll box below 992px, where it wraps to as many lines as it needs. |
Generator
ant_palette.py "#0B5FFF" # tokens.css (committed, never edited)
ant_palette.py "#0B5FFF" --contrast # the audit, below
ant_palette.py "#0B5FFF" --dark # the ramp under the dark algorithm
ant_palette.py --map # neutrals, status, dimensions, motion
ant_palette.py --map --dark
ant_palette.py --presets # the gray ramp, which is special-cased
tokens.css holds the seeded ramp alone. tokens.support.css holds everything else and is generated the same way: a script reads the four commands above and emits it, so nobody typed a value into either file.
The contrast audit, and what it changed
step hex on white on black use
5 #3381ff 3.67:1 5.72:1 hover state of the primary
6 #0b5fff 5.13:1 4.10:1 THE primary: colorPrimary
7 #0045d9 7.36:1 2.85:1 active / pressed
Step 8 (text) on white: 9.88:1 passes 4.5:1
White on step 6 (primary button): 5.13:1 passes 4.5:1
- White on step 6 passes at 5.13:1, where Ant's own
#1677fffails at 4.10:1. The primary fill carries text unchanged and needs no darker step. - The hover does need one. Ant lightens a primary button to step 5 on hover, which drops white text to 3.67:1. Hover is step 7 (7.36:1) and pressed is step 8 (9.88:1) instead, so the label holds AA through the whole press.
- Ant's Tag pairs step 7 on step 1 and three of the five hues used here fail: green 3.37:1, cyan 3.39:1, gold 4.25:1. Every tag reads step 9 on step 1, which measures 5.44:1 (green), 5.83:1 (cyan), 6.53:1 (gold), 7.04:1 (red) and 10.94:1 (geekblue).
colorBorderis 1.41:1 on white and bounds every control. The generator's gray ramp replaces it, picked by rule rather than by eye: the first step clearing 3:1 against that theme's container: gray 3 (#8c8c8c, 3.36:1) in light, gray 7 (#6a6a6a, 3.41:1) in dark.
- Target size (SC 2.5.8). Row checkboxes are 16px, which the spacing exemption carries: 43px between vertical neighbours and 40px to the reference link. The empty saved view carries no select-all, since a table with no rows has nothing to choose, and that also removes the only pair of 16px targets whose centres fell inside 24px of each other.
- The empty saved view carries no filter and no sort either, on the same argument, and it had to: those four controls shared ids and handlers with the open table above, so filtering from the empty header re-sorted and re-filtered a table 660px off the top of the screen while opening its popover at
top: -193px, where nobody could see it.
- Measured at 390px: the sentence wraps to six lines and 100% of it is visible, sticky at the left edge of the scroll box. Before the critique round it was one 1264px line inside a 308px box, so 9% of it showed.
Deviations from CONTRACT.md
- A second generated stylesheet.
tokens.csscarries only the ten brand steps, and a page needs neutrals, status hues, spacing, type, radius and motion. Those come fromant_palette.py --map,--map --darkand--presetsthrough a script intotokens.support.css, rather than being written into the page as raw values. - Ant ships no typeface, so the page loads no web font and uses the
fontFamilyandfontFamilyCodeseeds verbatim.
Uplift, 2026-10-29
The archetype stays Shell; the page now behaves like one of Ant's Pro templates.
- Data regenerated, not decorated. 140 consignments with 14-character MRNs (
26+ country + 14), HS codes with descriptions, VAT by destination, deterministic seed 1203, and "now" fixed at Thu 12 Mar 2026 11:20 CET. Every figure on the page (stats, chart, guarantee meter, counts in the nav) is computed from the same rows, so none can disagree. Money is€with a narrow no-break space and a true minus. - Pro layout. Sider, header, page header with breadcrumb and tabs, a query form that filters the table, column settings, density, selection with an alert bar, expandable rows holding a timeline, pagination.
- The interaction: releasing the guarantee. Customs holds a €3 000 000 guarantee; duty on cleared entries is drawn from it. Selecting entries and choosing Release opens a drawer that works out, in arrival order, which of them the headroom can cover, which are held or blocked at the border, and what is left. The officer's authorisation limit is validated, and the result states the new headroom. This is the product thinking: the table is not only read, it decides.
- Phone. Under 576px the 64px rail becomes a bottom bar of four tabs at 12px (it was 10px and failed the text floor), the table becomes one card per consignment, and the drawer becomes a bottom sheet.
- Contrast. Small metadata text moved from tertiary (0.45 alpha, 3.36:1 on white) to secondary; tertiary stays on non-text strokes only.
- Left on purpose. The 32px and 26px statistic figures sit off the type ramp as Ant's large Statistic does. Boson's
clipped-overlayon visually hidden labels is the scroll box clipping 1px screen-reader text below its fold.
Round two: the chart is the moment
An independent critic, judging the first fold cold, scored this page 7: the direct-labelled chart was good, the cards and sidebar generic.
- The chart spans the content width at 400px, with an area wash under the cleared line, 2.5px strokes and 15px direct labels, and a 336px column of Statistic-with-trend beside it in the same card: Held 14 at 48px with a red Tag, Cleared today at 38px with a green Tag, the other two at 28px. Held and Cleared lost their sparklines, since the chart draws that series.
- Deviation, stated. 48px is past Ant's 38px heading ceiling, for the one figure the desk opens the page to read.
- The Sider opens collapsed to Ant's 64px rail from 992px; the header's Descriptions row gains a Badge, "Open now" (11:20 inside 06:00 to 22:00 CET).
- On phones the trend Tags read "↑ 5 more"; the "than yesterday" noun is visually hidden there, not removed, so each Tag stays one line as Ant's Tag is, and a screen reader still hears the whole comparison.
.tablewrapmax-height went from 66dvh to 76dvh: the new layout put a clipped table link within 24px of the widen button, and 72 to 82dvh measured clean.
Round four
- The consignments table, wider than its card at 1440, now shows a soft edge on its right side while columns lie beyond it, and drops it when the last column is in view.
- "Rejected at the border" is an Ant Empty state (illustration, one line, one action) with the filter chips and count above it; the blank table head and body are gone.
- The held annotation left the plot: its sentence is the chart's caption under the plot at every width, so it no longer wraps in four ragged lines over the lines.
Round five: the table fits, and nothing clips
- Fourteen columns do not fit. They are 2162px; the card is 1311px at 1440. The table now drops its least-read columns until the rest fit and gives them back as the card widens (
DROPin the script): Incoterm, HS code, Carrier, Customs broker, Last event, Border ETA, Duty and VAT, Mode, in that order. Customs status (its filter lives only in its header), Declared value, Lane and Entry (MRN) are never dropped. At 1440 five columns go (Carrier, HS code, Incoterm, Broker, Last event) and nine show whole with no scroll and no fade; the column menu shows what is hidden, and a column switched on by hand stays. Carrier, broker and HS code are also in the row's detail, one click away. Below about 990px the kept columns scroll inside the card and the right-edge fade shows only while more lies to the right. - A 53-character broker made one row 83px tall beside 43px rows: the cell wrapped to three lines and the other cells sat at the top of blank space. Carrier and broker cells are one line with an ellipsis and the full text as the title.
scrollbar-gutter: stableis off the scroll box. It left the last 15px of the last column past the end of the scroll range, so the final column could not be scrolled whole into view.
Round nine: below the fold, dark, and the phone
- Width sweep, 320. The page header's title row now wraps, so "Rotterdam desk" drops under "Consignments" at 320 instead of scrolling the page 5px sideways.
- Dark guarantee meter. "This release adds" used step 3, which in the dark ramp is almost the track colour, so the one bar the drawer exists to show disappeared. A page variable now picks step 3 in light and step 8 in dark, for the bar and its legend swatch.
- Next to release no longer leaves 300px of void at 1440 and 700px at 1920: from 992px the guarantee sentence, set larger, sits beside the list behind a hairline, and the list is capped at 64rem.
- Phone. The third tab read "Waiting for release" and its count scrolled off at 390; under 576px it reads "To release" and all three tabs fit at 360. The bottom bar's active label is no longer bold, so "Consignments" stops touching both screen edges. In the drawer a reference no longer breaks over two lines, and the design-notes ratios (5.13:1) no longer break at the colon.
- Left. Boson reports
focus-not-visibleon every control; measured by keyboard each one has a 2px solid ring in both schemes, so its photograph comparison is wrong here. The chart's "Weekend" contrast finding reads black on black; the label is 65% text over a 4% band. At 360px the bar label has 2px to spare in the fallback face.
Round ten: the harsh second read
Round nine's score for this page was not recorded in this file, so there is no before-number to quote; the ten scores below were taken cold on the round-nine page, and again after the last edit.
| Heuristic | Before | After |
|---|---|---|
| Visibility of status | 3 | 3 |
| Match with the real world | 3 | 3 |
| User control and freedom | 1 | 3 |
| Consistency | 3 | 3 |
| Error prevention | 2 | 3 |
| Recognition over recall | 3 | 3 |
| Flexibility and efficiency | 3 | 3 |
| Aesthetic and minimal design | 3 | 3 |
| Error recovery | 3 | 3 |
| Help | 2 | 3 |
- Severity 3: a release had no way back, and an undo with no end is not a filing. The review drawer stays the confirmation step. On "Release 22 entries" the page updates at once (stats, chart, guarantee, row tags), and the release is held for 10 s before it is filed. When the drawer closes a fixed notice, with focus on it, says "22 entries go to customs in 10 s" and counts down; the journey of each entry reads "Filing with customs". Undo in that window restores every row, journey, figure and the guarantee. The count stops while the pointer moves over the notice or a keyboard focus is on a button in it (WCAG 2.2.1); a pointer that merely sits where the notice appears, under the Done button, does not stop it. At the end of the window the release is filed: the notice reads "Filed with customs at 11:20 by <officer>", Undo is gone and the journeys read "Released". "File now", the Dismiss button and Escape file it at once; opening another review files a pending one first. Only a release in its window can be undone.
- Severity 2: the notice must be seen. It is fixed, so it is in view wherever the table was scrolled, and focus moves to it when the drawer closes.
- Severity 2: what the broker is told before committing. The footer states the amount drawn next to the button. The drawer names what stays and why ("1 blocked at the office of departure, 7 waiting for headroom"), warns when an entry to be released carries an exception and prints that exception's sentence under its row (two at-border entries had one that the drawer hid), says in words that the release leaves under 1% of the guarantee free, and marks each officer whose limit is below the release instead of waiting for the submit. The outcome tag reads "Will release", not the bare verb.
- Severity 2: the page did not change after the act. A released entry's journey still ended "Waiting for release"; it now reads as a cleared entry's. The meter said 100% at EUR 2 988 464 of 3 000 000; it says 99.6%.
- Severity 2: Review release replaced the reader's selection and kept 30 rows selected after Cancel. Cancel and Escape give the selection back, and a release removes only what it released.
- Help where the figure is. The drawer's guarantee panel says duty is drawn from it and what headroom is.
- Severity 1: the bulk bar's "Release against guarantee" only opens the review, so it reads "Review release" like the other two. A wrong-limit error reddens only the officer chosen. On a phone the three guarantee figures are rows, so their baselines line up.
- The 30 and the 22. The header count is entries at the border. The drawer now says why 8 stay: "until the EUR 1 207 727 of headroom is spent. Staying where they are: 1 blocked at the office of departure, 7 waiting for headroom."
- Left. The notice covers the bottom-right of the page while it shows (severity 1, as Ant's own notification does). The 8 left over have no "raise the limit" action, since the brief gives none (severity 1).
- Inventions. The 10 s hold before filing and the undo inside it, the "Filing with customs" journey step, and the filing time shown as the page's fixed 11:20. The 5% threshold for the "leaves under" sentence. None is a price or a customs rule.
Round eleven (2026-11-10)
- Severity 3: the sentence and the journey never showed on a phone. The card rules hid every cell of a consignment but the summary ones, and the single colspan cell of a
.reasonrow (the exception sentence) and of a.detailrow (Journey, Goods, Duty and VAT) is the third cell, so both rows rendered at height 0 at 390 and 360 and the chevron flipped and opened nothing. The hiding rule now applies to the consignment's own row only (tr:first-child); the sentence and the journey keep their one cell, as at 800 and 1440. - Severity 2: the tabs acted on a table out of sight. Choosing a tab (click or arrow key) brings the table panel up when it starts past 60% of the viewport, the move "Show what is left" already makes. The tab bar leaves the screen; the table result is what the reader asked for.
- Severity 2: the drawer error was below the fold. After a failed submit the field keeps focus without scrolling, and the invalid group and its message are scrolled into the drawer body (the first problem last, so it wins).
- Severity 2: icon rail with no names. Hovering or keyboard-focusing a rail item (Sider collapsed, 576px and up) shows its label in a tip beside it, as Ant's collapsed Sider does. The tip repeats the screen-reader label, so it is
aria-hidden; Escape, leaving and scrolling the rail dismiss it. - Severity 2: phone control sizes. Drawer Cancel, Release and close, the officer rows with their radios, the origin-documents row and the row chevron are 44px targets at 575px and below.
- Left. The drawer's outcome table still scrolls inside the body (severity 1). The toast over the chart end, the shared count in the "Rejected at the border" panel and "EUR 1,180" in a sentence are severity 1 and untouched.
- Inventions. None. The 60% threshold for when a tab brings the table up is a layout rule, not a product fact.
Round twelve (2026-11-10)
- Severity 3: the release drawer clipped its figures on a phone. At 360 and 390 the drawer body measured 410px of content in a 360 or 390px view, so the guarantee figures lost their last digits and the right 50px could only be found by a sideways swipe. The cause was not round eleven's controls.
.dr-bodyis a grid with no column template, so its one implicit column was sized to the widest min-content of any child, and the outcome table (362px at its narrowest) set it, dragging the budget card and every paragraph out to 362px..dr-bodynow hasgrid-template-columns: minmax(0, 1fr): the column is the body, and the table scrolls inside its own labelled region. - A second defect the first fix uncovered. With the column no longer 362px wide, the officer rows, which put the long limit sentence ("up to EUR 500 000, below this release") beside the name, broke names mid-word ("Dilnoz/a Karim/ova") at 320 to 390. At 575px and below the limit now sits under the name and role, in the same column; the 44px row and the 24px radio are unchanged.
- Measured at 320, 360, 390 and 768, open and after Release with no approver: drawer, body and every child fit the viewport; the body is 320, 360, 390 and 600 wide. Left, severity 1 and unchanged: the outcome table (360px) scrolls inside its own focusable, labelled region at 320 to 390.
- Inventions. None.
Round fifteen (2026-11-10)
- Defect 1, reproduced: the page buttons and most controls were under 44px on a touch device. At 390 and 360 (isMobile, hasTouch, pointer: coarse) the smallest were the row checkboxes and the reference links (24px), the theme and sort segmented labels (24px), the page-size labels (24px high, 31px wide), the Portfolio link (24px), "Widen to seven days" (24px), and at 32px Export CSV, Review release, the search field, the broker picker, Reset, Expand and the five page buttons.
- Fix 1. One
@media (pointer: coarse)block after the phone block. Ant's own control-height tokens carry it (--ant-control-height,-smand-lgbecome 44px), so every button, input, picker, page button and popover row follows from the one change; the desktop keeps Ant's 32px and 24px because a mouse is not coarse. The segmented labels get 44px height and width, the Portfolio link 44px, the reference link a 44px box with a negative margin so the card does not grow, and the row checkbox is drawn (appearance: none, a 44px box holding the 24px square and tick) because a native checkbox ignores padding. Measured after, at 390 dark and 360 light across the table, a selected row, an expanded row, the empty state, the release drawer (error, ready, result) and the undo strip: the smallest interactive element is 44px (the Portfolio link was 24px before). Not coarse (1440, 1920) is unchanged. - Defect 2, reproduced: "At the border" was a hollow tile at 390 and 360. The phone rules hid its "of 140", its sparkline and its delta, while the Duty tile beside it set the row height, so the tile read "30" over empty space.
- Fix 2. The phone tile grid now shows what the desktop shows: "of 140" and "entries" / "so far" return, the sparkline returns, and every delta returns with its noun ("than yesterday"). The tag wraps its noun to a second line inside the tag instead of dropping it, so it never overflows the tile. The sparkline and the meter both sit at the foot of their tiles. The caption under the meter balances its wrap so "limit" is not alone on a line at 360.
- Other severity 1 notes from the reviewer, fixed. (b) deltas read "5 more" without "than yesterday": fixed by Fix 2. (c) Review release and the page buttons 32px: fixed by Fix 1. (d) at 360 the bottom bar label "Consignments" started 2px from the left edge: the label is 11px at 380px and below, so it has about 6px each side. (e) "Held" sat 5px lower than "Cleared today":
.stat:first-childkept a larger top padding on the phone; the two now share one. - Left. The reviewer's other notes (the notes panel as plain text on a phone, icon-only rail at desktop) are not severity 1 fixes of a few lines and are untouched.
- Inventions. None. 44px is the touch size the fix task set, not a product fact.