Audit spacing scale against mobile specs

APL-214 opened by Noah Reed on Aug 04, 2026 · 4 comments

Description

The spacing scale we ship diverges from the mobile specification in three places, so the same component renders with different rhythm on web and in the app.

Steps 4, 5 and 7 are the offenders — mobile rounds them to the 4px grid while web keeps the raw ratio values. Anything built from those steps inherits the drift.

Audit every consumer of the scale, agree a single rounding rule with the mobile team, and publish the corrected tokens with a migration note for the three affected steps.

Sub-issues

1 / 3 · 33%

Linked issues

Blocked by

Relates to

Activity

  1. Noah Reed created this issue · Aug 04

  2. Noah Reed added the labels Foundations design · Aug 04

  3. Ava Mitchell Aug 05 · 09:12

    Worth checking whether the mobile values were rounded deliberately or just inherited from the old grid. If it was deliberate we should match them rather than re-derive the ratio.

  4. Ava Mitchell assigned Noah Reed · Aug 05

  5. Noah Reed Aug 06 · 14:38

    Checked with the mobile team — it was deliberate. They round every step to the 4px grid because sub-pixel values cost them a layout pass on older devices.

  6. Noah Reed changed status from To Do to In Progress · Aug 06

  7. Mia Torres marked this as blocked by APL-203 · Aug 07

  8. Mia Torres Aug 07 · 11:05

    Blocking on APL-203 — no point publishing corrected tokens until the base grid decision is signed off, or we will migrate twice.

  9. Ava Mitchell set the estimate to 5 points · Aug 08

  10. Liam Foster Aug 10 · 16:20

    Audit sheet is attached. Three steps drift, exactly as described — 4, 5 and 7. Everything else matches to the pixel.