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
- Checkbox and radio
- Chip
- Colour picker
- Combobox
- Icon toggle
- Multiselect
- Removable tag
- Segmented control
- Select
- Switch
Navigation
- Account menu
- Bottom navigation
- Breadcrumb
- Command palette
- Link
- Page header
- Pagination
- Progress steps
- Side navigation
- Tabs
- Top bar
- Tree view
Feedback
- Banner
- Callout
- Empty state
- Feedback control
- Inline notice
- Offline state
- Page loader
- Progress and loading
- Skeleton
- Spinner
- Status dot
- Sync status
- Toast
Overlays
Layout
Data display
- Badge
- Budget top sheet
- Code block
- Dailies day
- Data table
- Description list
- Element tag
- Keyboard key
- List row
- Meter
- Stat
Data visualisation
- Area chart
- Bar chart
- Dailies frame
- Donut chart
- Gantt chart
- Line chart
- Production timeline
- Scene density heatmap
- Sparkline
- Story spine
Media
- Bin
- Compare viewer
- Lightbox
- Location card
- Media grid
- Project cover
- Source and program viewers
- Storyboard frame
- Video player
- Waveform
Creative tools
- ADR cue list
- Audio meter
- Breakdown page
- Call sheet
- Camera setup card
- Cast board
- Channel strip
- Character card
- Character page header
- Clip inspector
- Clips and grade versions
- Colour curves
- Colour wheels
- Edit timeline
- Index card
- Looks and LUTs
- Loudness meter
- Marker list
- Mixer
- Node graph
- Outline board
- Parametric EQ
- Playhead and scrubber
- Production calendar
- Quick note
- Screenplay elements
- Screenplay page
- Script timeline
- Shot card
- Sound tracks
- Stripboard strip
- Timecode display
- Transport bar
- Video scopes
AI and authorship
- Agent activity
- Agent plan
- AI consent prompt
- AI result review
- AI undo history
- Prompt input
- Provenance label
- Revision mark
- Suggestion panel
Collaboration
- Avatar
- Board column
- Comment pin
- Comment reaction
- Notification bell
- Presence cursor
- Research card
- Script revision diff
- Version history
Rules for agents
- Must use the component that exists before writing a new one; search this catalogue and
components.jsonfirst. - 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