Concepts
Every term parlance uses, in plain English. These are the same definitions the app shows in its ? hints, so a concept means exactly one thing everywhere.
Workspace
Your top-level container — a personal space or a shared organisation. Design systems, projects and members all live inside a workspace.
Organisation
A shared workspace for a team, with members and roles. (A personal workspace is just for you.)
Design system
The shared definition — glossaries, colour roles and contracts — that one or more projects use. Your source of truth for how things should look and behave.
Project
A project that uses a design system — a website, app or platform. Several projects can share one design system.
Contract
A UI contract — the agreed specification for a component (a button, a form field), described clause by clause.
Clause
One rule inside a contract — a single property (padding, font-size, colour…) and the value it must have, optionally tied to an accessibility standard.
Glossary
A named set of design values of one kind (spacing, colour, typography…). Contracts source their clause values from glossaries.
Glossary value
One named value in a glossary — e.g. “space-sm = 8px”. The reusable token a clause points at.
Design token
A named, reusable design value — a colour, a spacing step, a radius. Stored as glossary values.
Atomic level
How complex a component is — atom → molecule → organism → template → page. A button is an atom; a form field is a molecule.
Theme
Maps semantic colour roles (primary, error…) to light- and dark-mode shades, with live WCAG contrast checks.
Colour role
A semantic colour slot (primary, error…) that resolves to a different shade in light vs dark mode.
Audit
A check of an observed thing — a design, code, a live page or a native screen — against a contract, producing a score and a list of issues.
Issue
A single mismatch found by an audit: what was expected vs what was observed, with a severity.
Conformance
How well each project matches its design system across design, live and accessibility — rolled up per project, with a worst-case headline.
Standard
An accessibility rule from an external spec (WCAG 2.2, WAI-ARIA, Section 508, EN 301 549) that a clause or issue can reference.
WCAG level
The conformance level — A (basic), AA (the common legal target) or AAA (strictest).
API key
A per-user secret that lets the extensions (Figma, browser, VS Code, native…) connect to your parlance data through the API.