The interface as it stands, written down for the redesign (#185)

[Devski]

What

• docs/ui-specification.md (new): the interface as it stands on main at ae55b6c, written for the agent that will implement the redesign.
  • §0 tells that reader how to use the document, and §1 defines the modes: who is looking, view or edit, desktop or phone, pl or en, reduced motion, input kind.
  • §2–§8 go view by view: the site map, shared elements with the top bars, the homepage and 404, sign-in screens, onboarding and account settings, the profile page, works.
  • §9 is the component catalogue and design tokens. §10–§11 index 125 design decisions and 139 inconsistencies.
  • The appendices list the screenshots, dictionary namespaces, server endpoints and end-to-end tests.
• Every control is described the same way: label (the Polish copy with its key and an English gloss), where it sits, when it is shown, what it does, its states, input, accessibility, tests and source.
• Decisions and inconsistencies are kept apart. Decisions (D-*) name their source. Findings (F-*) name their evidence, and duplicates point to one ID so every ID stays stable.
• Screenshots stay out of the repository. The 50 shots of dev, with the tall ones cut into readable parts, are on a private page: https://claude.ai/code/artifact/37a17f91-9bd7-4641-8108-448f20987ac3.
• SPEC.md: the header links the document. §9 no longer says works are ordered by created_at; the code has ordered them by position since Small things to polish: a logo that stops leading away, two lists that keep their order, and a place a phone can add #66 (F-WORKS-1). This is the only finding fixed here.
• tasks/plan.md: UI specification before the redesign: every view in every mode, every control, the top bar #185 is listed under Full functionality.
• .prettierignore: the document is left out. Aligning its tables would grow it by nearly 30%, all of it whitespace an agent reads as tokens.

How it was checked

• Code, then dev. Written from the code, then walked on dev on the dawidwroblewski-a3d-1 profile: signed out and as the owner, desktop and phone, pl and en. Nothing was saved, uploaded or deleted on the account.
• Completeness script. Every page route, UI file, dictionary namespace, API route and end-to-end spec in the repository is referenced. Every ID is unique, and every reference resolves.
• Two verification agents re-read §2–§6 and §7–§8 against the code. Their 52 corrections are applied.
• pnpm check passes (typecheck, lint, unit tests). No application code changed, so there was no build.

Found along the way

• F-AUTH-26: a signed-in session can turn e-mail two-factor on from /two-factor with a mailed code and no password. Added to Two-factor: an authenticator account can still be passed with an e-mailed code #59 as a comment, because the server-side gate that issue asks for closes it too.
• The other findings are listed, not fixed and not filed as issues. The redesign decides which of them survive.

Closes #185.

🤖 Generated with Claude Code