**21:10 — 26 October 2026**

# Design standards - Steve's projects

The house rules for anything we design. Give this file to Claude Design (or any designer) before a design job:
https://www.perfectportals.com/design-studio/standards.html

Most of it comes from the Odeon "Nordic" redesign (October 2026). Where a rule is Odeon-only it says so.
Live reference: https://www.perfectportals.com/odeon/nordic-v3/ (the colours live in its `nordic.css`).

---

## 1. How Steve works with design
- **Concept and meaning first; looks follow.** Get the idea right, then make it pretty.
- **Show options, not one answer.** Three or four different approaches he can mark yes / no / maybe beat one
  polished guess. Seeing an idea he rejects is still progress.
- **Judge in place.** Options go on the real page (a drop-down or tick to switch), not on a separate mock, when possible.
- **A re-skin is not a redesign.** Same sizes and spacing with new colours is useless; change type scale,
  spacing and placement too (functions stay the same).
- **Kill friction.** The thing he does most must be one tap, especially on the phone.
- **Phone = Samsung Galaxy A34**, Chrome, 412 x 915 upright, 915 x 412 on its side. Check both.
- No sideways scrolling at any width. Full film names - no "A.." truncation where it can be avoided.

## 2. Colour
- **Every colour is defined in ONE style file** and used by name (`var(--name)`), never typed into a page.
  (Odeon: `nordic.css`, checked by `check-colours.js`.)
- **Only named palette colours.** A new colour is added to the palette on purpose, with a reason.

### Palette - "Nordic" (light)
| Name | Hex | Use |
|---|---|---|
| bg | #F4F6F8 | page background |
| panel | #FFFFFF | cards, header bar, side panels |
| panel-alt | #E9EEF3 | image backgrounds, empty cells |
| sel | #E0F0FA | selected / booked row, hover |
| line-soft / line / line-strong | #E8EDF2 / #E2E8F0 / #CBD5E1 | dividers / borders / button outlines |
| text | #1E293B | main text |
| text2 | #334155 | secondary text |
| muted | #64748B | labels, meta, inactive nav |
| accent | #0273B3 | links, booked, selected, active nav |
| must1 / must2 / must3 | #6FB7AE / #2F8F86 / #0F766E | Must See 1, 2, 3 stars (light to dark teal) |
| rt-fresh | #15803D | good score (green-700) |
| cs | #4D7C0F | CinemaScore grade (lime-700) |

### Warning colours - option F "tinted pills" (chosen 26 Oct 2026)
| Name | Hex | Use |
|---|---|---|
| warn | #991B1B | warning words, rotten scores (red-800, 8.3 : 1 on white) |
| caution | #92400E | caution words, GOING (amber-800, 7.1 : 1 on white) |
| warn-bg / caution-bg | #FEF2F2 / #FFFBEB | banner backgrounds |
| warn-edge / caution-edge | #FCA5A5 / #FCD34D | banner left edges |
| pill backgrounds | #FEE2E2 (red) / #FEF3C7 (amber) | small pills: tight gaps, GOING |
Why F: the original design made urgent things look like everything else; pills are clear in lists without shouting.

### Accessibility (WCAG 2.2 AA)
- Text: **4.5 : 1** against its background (large text 3 : 1).
- Icons, edges, chart marks: **3 : 1** (non-text contrast).
- Never rely on colour alone: add a word, symbol (⚠ ✓) or shape (size, outline, stripe).
- Check every new colour pair with a contrast checker and write the ratio next to it.

## 3. Type
- Headings / big numbers: **Bebas Neue** (all caps, tight). Body and UI: **Barlow** 400-700.
- Times and dates are big and scannable; labels are small caps with letter-spacing.

## 4. Layout and behaviour (Odeon)
- Menu: ☰ on the left, then LISTINGS · DOUBLE BILLS · GANTT; site name "Odeon" in accent blue on the right.
- PC: three columns (films · showings · film card). Narrower: two. Phone: one, with a bottom-sheet film card.
- Hiding a film, Must See and booking must each be reachable in one or two taps from the list itself.
- Settings save to the server, read-modify-write, and a failed save says so and puts things back.
- Every page shows when its data was last fetched ("Listings 26/10 12:30") and when the page was built.

## 5. Writing on the page
- Plain words. Say what a thing does ("Untick a film to hide it"), not what it is.
- Dates as "Mon 26 Oct"; times 24-hour. Check weekday names with a real calendar.

## 6. Open questions (not standards yet)
- Gantt bars: booked / big screen / normal - options 1-7 on the v3 Gantt "Bars" drop-down.
- Film list at the top of Listings: options A-D on the v3 "Films" drop-down.

## Sources
- WCAG 2.2 contrast: https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html and
  https://www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html
- Nord palette (name and the Aurora warning hues): https://www.nordtheme.com/docs/colors-and-palettes
- Tailwind colour scale (the "700" family): https://tailwindcss.com/docs/colors
- Presentation Steve admires: https://designsystem.tech.gov.sg/templates/page-templates/preview/application-management
