Skip to main content
Parlance — home

Quickstart

This guide takes you from a new account to your first audit in a few minutes.

1. Create your account

Open sign in and create an account with your email and a password — or continue with Google, GitHub, GitLab or Apple. You can add two-factor authentication and a passkey afterwards from Account → Security. See authentication for the full list of options.

2. Create a design system and its foundations

A workspace is your top-level container. You start in a personal workspace automatically — no setup needed — and can create shared workspaces for a team later from Account → Organisations.

A design system is where your contracts and shared vocabulary live. Its Foundations page holds the glossaries your contracts draw on — colour, spacing, type and motion.

  • From your workspace dashboard, create a design system.
  • Open Foundations and create a colour glossary — or, once starter presets are available, adopt a ready-made starter set from the Start from a preset card with the Adopt button.
  • Use Generate ramp to produce a 50–950 scale, and define your semantic light and dark roles in the Theme editor. Contrast is checked live against WCAG 2.2.

See glossaries & tokens for the detail.

3. Define a contract

A contract describes what a component must be. Each clause ties a property (for example background, padding-x or contrast) to a value sourced from your glossary.

  • In your design system, create a contract for a component (say, Button / primary).
  • Add clauses, choosing values from the glossary so design and code share one source of truth.

See UI contracts for clause types and component hierarchy.

4. Create a project

A project is a product you want to keep honest: a website, an app or a platform. Projects that use a design system are audited against its contracts.

  • Add a project from the Projects section of the sidebar (the + button), or from your design system's Conformance page — give it a name and a short description (the slug is derived for you) and link it to your design system.
  • Prefer to start here? Creating a project can auto-create a design system for you to build on.

5. Run your first audit

Open a contract in your design system and choose Run audit, then pick the project to check it against — a design file, a code repository, a live URL or a native app. In the platform you record the audit manually, working through the contract clause by clause; to capture results automatically, run one of the extensions — in Figma, the browser, VS Code or Xcode — and push the results back to your project. Issues are grouped by severity, and drift (where a source disagrees with the contract) is flagged so you can fix it.

See audits to learn how issues and severities work.

Next steps