# AGENTS.md: working with Nuvola Nuvola (Allegro Nuvola) is staff software for a Dutch municipal credit bank. Case workers use it under time pressure with residents in financial stress: calm, readable, nothing decorative. ## Where things are | What | URL | Notes | |---|---|---| | Design system (live components and rules) | /app/design | The source of truth for how things look and behave | | Motion patterns | /app/design/beweging | Experiment; durations and easings per pattern | | Tokens | /assets/tokens.css | Use the `--nv-*` variables; never hardcode hex values | | Rules | /assets/rules/ | Markdown with a header; only `status: decided` rules are binding | | Decisions | /assets/running-decisions.md | Newest decisions last; they override older docs | | Prototype | /app/, /app/begroting, /app/tables | Next.js; the reference implementation | ## Rules you must follow 1. **Copy.** UI text is Dutch and comes from the designer or the existing app. Never invent on-screen copy, labels or help text. If text is missing, leave a clear placeholder and say so. 2. **Names.** Code identifiers and docs in English. 3. **Shape.** Everything is square: buttons (also the lime accent), fields, tiles, panels. Round only: the small close button on overlay corners, radio circles, status dots, the result arrow. 4. **Fields.** On the paper: outlined, square, transparent, label in the frame line. Inside data tables: the flat line style. Labels never truncate; they wrap. 5. **Buttons.** Three levels by urgency, one primary per view: primary (Dennengroen on paper, Limoen on the green window), neutral (sage tile), optional (subtle tile). 6. **Colour.** Palette: Dennengroen #1d3a2e, Papier #f7f1e8, Antraciet #3f4545, Groen diep #12271e, Limoen #d9e77c, Groen licht #bfd1c5. Limoen never as text or ring on the paper. Text AA (4.5:1) minimum; measure, do not guess. 7. **Depth.** Soft layered shadows only (`--zacht-1/2/3`), never hard edges or borders for structure. 8. **Motion.** Functional only. Hover changes colour (or shadow), nothing moves on keyboard focus, `prefers-reduced-motion` removes movement, nothing animates on load. 9. **Accessibility.** WCAG 2.2 AA minimum: one visible focus ring, accessible names, no meaning by colour alone, errors say how to recover. 10. **Type.** Titles and big numbers: Merriweather Sans. UI text: Inter. Long reading text: Merriweather (serif). ## When unsure Ask the designer instead of guessing. Report what you changed, what you did not verify, and why.