Kwark. Design System
Open Kwark
Design SystemComponents

Component catalogue

Every part Kwark is built from, drawn from the running app, with where each variant lives, its exact geometry, and the rules an agent must follow to use it.

Components

How to read this catalogue

Each specimen is the Kwark component as the app draws it, measured from the running app or translated from its source in components/ui, pages/** and styles/tokens.css. Where Kwark draws the same thing in more than one way, the page shows each look as a variant and says where it lives: the Button has the shared button, the story-surface button used in modules and dialogs, and the light resume control on Project home.

Every component page has five tabs: Usage (when, when not, variants, writing), Style (anatomy with measurements, and the tokens it uses), Code (the React import and props where the app has one, and framework-free HTML with kwark.css), Accessibility (keyboard and ARIA) and For agents (rules and a readiness test).

Status

Label Means
In the app Kwark has this component. The Code tab names the file.
Ready for Kwark Kwark does not have it yet. It is specified in Kwark’s tokens, corners, type and voice so it can be built without a new look. The page says what Kwark does today instead.
New A design-system proposal the app is adopting, such as the revision mark.

Some pages also carry a section called Moving older code over. It names where the app still draws an older style (upper-case button labels, the legacy badge, the old confirm dialog) and which look replaces it when that file is next touched (docs/design-system.md, section 7).

Start with what Kwark is made of

The film’s own artefacts

Machines and authorship

Kwark never judges the script (Decision 0002). These parts let a machine find, move, carry or convert the writer’s own material, and nothing more. Read AI and authorship first.

All components by job

Components are grouped by what they do: Actions, Inputs, Selection, Navigation, Feedback, Overlays, Layout, Data display, Data visualisation, Media, Creative tools, AI and authorship, and Collaboration.

Actions

Inputs

Selection

Feedback

Overlays

Layout

Data display

Data visualisation

Media

Creative tools

AI and authorship

Collaboration

Rules for agents

  • Must use the component that exists before writing a new one; search this catalogue and components.json first.
  • Must pick the variant named for the place you are building (a module page uses the story-surface button; Home’s blue is only for New project and Sign in).
  • Never copy an older style a page lists under Moving older code over.
  • Never present a Ready for Kwark component as something the app already has.

Find a workflow

Screenwriting, Scheduling and call sheets, Editing, and Building with agents show how these parts work together.

AI readiness test

Task. Build the footer of the date editor in Prepare to shoot: delete, cancel and save.

Give the agent. This page, Button, Dialog.

Constraint. The dialog is a story dialog in a module.

A reliable answer

  • Uses the story-surface buttons (36px, 6px corners, 12px)
  • Delete at the far left, Cancel then Save at the right with Save primary
  • No Home blue
  • No upper-case labels

Give this Markdown to your coding agent or share its URL.

Open .mdllms.txt
Loading…