Resources
Divergence Register
Where the Figma file and the shipped application disagree, this register rules. Behaviour defaults to the app; visual intent to Figma; purple artifacts are excluded as Tuluna legacy. Ten rulings, audited 2026-06-11.
Palette law (global ruling)
Purple, lavender, violet and magenta belong to Tuluna and are excluded from every Peri token, component and example. The two known purple artifacts in the Figma file are rulings #3 and #4 below — they are documented here and nowhere else.
The register
| # | Topic | Figma | Shipped app | Ruling |
|---|---|---|---|---|
| 1 | Top bar | orange gradient, white content | white bar, brown content, sync status | Gradient = design intent; both documented |
| 2 | Tab bar | some frames show 4 tabs (Insights/Treatments/History/Profile) | 3 tabs + FAB; History/Profile in drawer | App canonical |
| 3 | Bottom sheet artifact | purple FAB + lavender tiles (node 15:2920) | warm orange Log Activity drawer | Excluded — Tuluna legacy |
| 4 | Nav shadow | purple-tinted #6E3BD814 | neutral shadow | Excluded — use warm #D8873B1F |
| 5 | Primary dark | #C2581D | --accent-dark: #C94800 | Both kept: dark-ui (small active elements) vs dark-gradient (gradient end) |
| 6 | Onboarding | 4 steps, per-step skips | 3 steps (cycle, sleep, symptoms) | App canonical |
| 7 | Home dashboard | capability ring · Recovery Capacity bar chart · Training Capability card | DailyFocus / Fueling / RecentTrends / WhatNext cards | Figma = next visual direction; behaviour per app |
| 8 | Content margins | 24px | 16px | App canonical (16px) |
| 9 | Notifications bell | present in top bar | not shipped | Figma-only; excluded from feature inventory |
| 10 | Treatments export | PDF flow (generating → export-ready sheet, share/download) | CSV per category (peri-{category}-export.csv) + toast | App canonical (CSV); PDF = visual intent |
How to add a ruling
- 01Name the surface and both observed states (Figma node id, app file).
- 02Decide: app-canonical (behaviour), Figma-intent (visual), both-kept (with distinct roles), or excluded (legacy).
- 03Record the ruling here and reference it from the affected component page.
- 04Never resolve silently — an undocumented divergence is a future regression.