Before: an app with no design system

takenote

a public, open-source notes app

Audit result, 2026-10-25 · github.com/taniarascia/takenote · MIT · e0eddbb9a21a

16/ 100 overallLoose threads

  • 0 / 43components with a usage contract
  • 0 / 37components an agent could find by name with an import
  • 13interface elements in use with no contract or rule
  • 77files of product code read

Score per area

  1. Foundations and tokens41
  2. Components14
  3. Patterns and pagesnot assessed
  4. Usage17
  5. Governance10
  6. Brand, illustration, microcopy and localisation0
  7. Tools and sync26
  8. AI readiness0

Top findings

  1. Critical0 of 43 components have a usage contract

    Contract stubs are generated for every component with the evidence we could find and explicit 'missing' fields for purpose, when/when-not, states, behaviour, a11y and content.

  2. High36 proto-tokens live in preprocessor variables with no types, roles or descriptions

    Promote these to typed DTCG tokens and add a semantic layer (text, surface, border, action, status) on top; generated proposal in artefacts/tokens.

  3. High1 role token duplicate another token's literal colour

    Replace each duplicate with an alias ({palette.x}); two literals with the same value drift apart on the first edit.

Real audit output: Loom's audit of takenote (MIT), scored with Loom's open rubric.