# 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.

Source: https://kwark.space/designSystem/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](https://kwark.space/designSystem/components/button.md) 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](https://kwark.space/designSystem/components/revision-mark.md). |

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

- [Button](https://kwark.space/designSystem/components/button.md): Starts an action. Kwark draws it in three places with three weights: the shared button, the story-surface button in modules and dialogs, and the light resume control on Project home.
- [Breadcrumb](https://kwark.space/designSystem/components/breadcrumb.md): Keep the project, phase and active module visible as a filmmaker moves between rooms.
- [Menu](https://kwark.space/designSystem/components/menu.md): A short list of commands that opens from a button or a right-click. Desktop-grade, with shortcuts.
- [Dialog](https://kwark.space/designSystem/components/dialog.md): Stops the work to ask one question or collect a small form. Use rarely.
- [Toast](https://kwark.space/designSystem/components/toast.md): Give a short receipt for an action, with enough time to dismiss it or undo it.
- [Floating dial](https://kwark.space/designSystem/components/floating-dial.md): On phones, one 48px button at the foot of the screen that fans out Comments, Quick note and Account.

## The film’s own artefacts

- [Project cover](https://kwark.space/designSystem/components/project-cover.md): The poster a project wears at 2:3, with its one ⋯ cover menu inside the poster, and a designed placeholder when there is no cover.
- [Index card](https://kwark.space/designSystem/components/index-card.md): A beat or scene on card stock: a title above a red rule, notes on blue lines, and where it lands in the script.
- [Stripboard strip](https://kwark.space/designSystem/components/stripboard-strip.md): A scene as a strip of coloured paper: white, yellow, blue or green for interior or exterior, day or night. Days hold strips.
- [Call sheet](https://kwark.space/designSystem/components/call-sheet.md): The day's sheet on paper: production, call time, scenes, cast, locations and safety, issued as numbered, frozen revisions.

## 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](https://kwark.space/designSystem/foundations/ai-and-authorship.md) first.

- [Revision mark](https://kwark.space/designSystem/components/revision-mark.md): How Kwark marks what a machine proposed from the writer’s own material: a margin star and a dotted rule, until a person makes it their own.
- [Suggestion panel](https://kwark.space/designSystem/components/suggestion-panel.md): Proposals drawn from the writer’s own material, kept beside the page and not in it: a heading from an outline beat, a prop the script mentions.
- [AI result review](https://kwark.space/designSystem/components/ai-review.md): A batch of proposals drawn from the writer’s own material, each shown in place with its source and its own Use or Not needed.
- [AI consent prompt](https://kwark.space/designSystem/components/ai-consent.md): Before anything a person writes leaves the device: what is sent, to whom, what is kept, and a choice that starts off.

## 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

- [Button](https://kwark.space/designSystem/components/button.md)
- [Button group](https://kwark.space/designSystem/components/button-group.md)
- [Copy field](https://kwark.space/designSystem/components/copy-field.md)
- [Floating action button](https://kwark.space/designSystem/components/floating-action.md)
- [Floating dial](https://kwark.space/designSystem/components/floating-dial.md)
- [Icon button](https://kwark.space/designSystem/components/icon-button.md)
- [Split button](https://kwark.space/designSystem/components/split-button.md)
- [Text button](https://kwark.space/designSystem/components/text-button.md)

### Inputs

- [Date picker](https://kwark.space/designSystem/components/date-picker.md)
- [File uploader](https://kwark.space/designSystem/components/file-upload.md)
- [Number stepper](https://kwark.space/designSystem/components/number-stepper.md)
- [Search field](https://kwark.space/designSystem/components/search-field.md)
- [Slider](https://kwark.space/designSystem/components/slider.md)
- [Text input](https://kwark.space/designSystem/components/text-input.md)
- [Textarea](https://kwark.space/designSystem/components/textarea.md)
- [Time picker](https://kwark.space/designSystem/components/time-picker.md)

### Selection

- [Checkbox and radio](https://kwark.space/designSystem/components/checkbox-and-radio.md)
- [Chip](https://kwark.space/designSystem/components/chip.md)
- [Colour picker](https://kwark.space/designSystem/components/colour-picker.md)
- [Combobox](https://kwark.space/designSystem/components/combobox.md)
- [Icon toggle](https://kwark.space/designSystem/components/icon-toggle.md)
- [Multiselect](https://kwark.space/designSystem/components/multiselect.md)
- [Removable tag](https://kwark.space/designSystem/components/removable-tag.md)
- [Segmented control](https://kwark.space/designSystem/components/segmented-control.md)
- [Select](https://kwark.space/designSystem/components/select.md)
- [Switch](https://kwark.space/designSystem/components/switch.md)

### Navigation

- [Account menu](https://kwark.space/designSystem/components/account-menu.md)
- [Bottom navigation](https://kwark.space/designSystem/components/bottom-navigation.md)
- [Breadcrumb](https://kwark.space/designSystem/components/breadcrumb.md)
- [Command palette](https://kwark.space/designSystem/components/command-palette.md)
- [Link](https://kwark.space/designSystem/components/text-link.md)
- [Page header](https://kwark.space/designSystem/components/page-header.md)
- [Pagination](https://kwark.space/designSystem/components/pagination.md)
- [Progress steps](https://kwark.space/designSystem/components/stepper.md)
- [Side navigation](https://kwark.space/designSystem/components/side-navigation.md)
- [Tabs](https://kwark.space/designSystem/components/tabs.md)
- [Top bar](https://kwark.space/designSystem/components/top-bar.md)
- [Tree view](https://kwark.space/designSystem/components/tree-view.md)

### Feedback

- [Banner](https://kwark.space/designSystem/components/banner.md)
- [Callout](https://kwark.space/designSystem/components/callout.md)
- [Empty state](https://kwark.space/designSystem/components/empty-state.md)
- [Feedback control](https://kwark.space/designSystem/components/feedback-control.md)
- [Inline notice](https://kwark.space/designSystem/components/inline-notice.md)
- [Offline state](https://kwark.space/designSystem/components/offline-state.md)
- [Page loader](https://kwark.space/designSystem/components/cinematic-loader.md)
- [Progress and loading](https://kwark.space/designSystem/components/progress.md)
- [Skeleton](https://kwark.space/designSystem/components/skeleton.md)
- [Spinner](https://kwark.space/designSystem/components/spinner.md)
- [Status dot](https://kwark.space/designSystem/components/status-dot.md)
- [Sync status](https://kwark.space/designSystem/components/sync-status.md)
- [Toast](https://kwark.space/designSystem/components/toast.md)

### Overlays

- [Context menu](https://kwark.space/designSystem/components/context-menu.md)
- [Dialog](https://kwark.space/designSystem/components/dialog.md)
- [Drawer](https://kwark.space/designSystem/components/drawer.md)
- [Menu](https://kwark.space/designSystem/components/menu.md)
- [Popover](https://kwark.space/designSystem/components/popover.md)
- [Sheet](https://kwark.space/designSystem/components/sheet.md)
- [Tooltip](https://kwark.space/designSystem/components/tooltip.md)

### Layout

- [Accordion](https://kwark.space/designSystem/components/accordion.md)
- [Card](https://kwark.space/designSystem/components/card.md)
- [Divider](https://kwark.space/designSystem/components/divider.md)
- [Toolbar](https://kwark.space/designSystem/components/toolbar.md)

### Data display

- [Badge](https://kwark.space/designSystem/components/badge.md)
- [Budget top sheet](https://kwark.space/designSystem/components/budget-top-sheet.md)
- [Code block](https://kwark.space/designSystem/components/code-block.md)
- [Dailies day](https://kwark.space/designSystem/components/dailies-day.md)
- [Data table](https://kwark.space/designSystem/components/data-table.md)
- [Description list](https://kwark.space/designSystem/components/description-list.md)
- [Element tag](https://kwark.space/designSystem/components/element-tag.md)
- [Keyboard key](https://kwark.space/designSystem/components/keyboard-key.md)
- [List row](https://kwark.space/designSystem/components/list-row.md)
- [Meter](https://kwark.space/designSystem/components/meter.md)
- [Stat](https://kwark.space/designSystem/components/stat.md)

### Data visualisation

- [Area chart](https://kwark.space/designSystem/components/area-chart.md)
- [Bar chart](https://kwark.space/designSystem/components/bar-chart.md)
- [Dailies frame](https://kwark.space/designSystem/components/dailies-frame.md)
- [Donut chart](https://kwark.space/designSystem/components/donut-chart.md)
- [Gantt chart](https://kwark.space/designSystem/components/gantt-chart.md)
- [Line chart](https://kwark.space/designSystem/components/line-chart.md)
- [Production timeline](https://kwark.space/designSystem/components/production-timeline.md)
- [Scene density heatmap](https://kwark.space/designSystem/components/heatmap.md)
- [Sparkline](https://kwark.space/designSystem/components/sparkline.md)
- [Story spine](https://kwark.space/designSystem/components/story-spine.md)

### Media

- [Bin](https://kwark.space/designSystem/components/bin.md)
- [Compare viewer](https://kwark.space/designSystem/components/compare-viewer.md)
- [Lightbox](https://kwark.space/designSystem/components/lightbox.md)
- [Location card](https://kwark.space/designSystem/components/location-card.md)
- [Media grid](https://kwark.space/designSystem/components/media-grid.md)
- [Project cover](https://kwark.space/designSystem/components/project-cover.md)
- [Source and program viewers](https://kwark.space/designSystem/components/viewer-pair.md)
- [Storyboard frame](https://kwark.space/designSystem/components/storyboard-frame.md)
- [Video player](https://kwark.space/designSystem/components/video-player.md)
- [Waveform](https://kwark.space/designSystem/components/waveform.md)

### Creative tools

- [ADR cue list](https://kwark.space/designSystem/components/adr-cue-list.md)
- [Audio meter](https://kwark.space/designSystem/components/audio-meter.md)
- [Breakdown page](https://kwark.space/designSystem/components/breakdown-page.md)
- [Call sheet](https://kwark.space/designSystem/components/call-sheet.md)
- [Camera setup card](https://kwark.space/designSystem/components/camera-inspector.md)
- [Cast board](https://kwark.space/designSystem/components/cast-board.md)
- [Channel strip](https://kwark.space/designSystem/components/channel-strip.md)
- [Character card](https://kwark.space/designSystem/components/character-card.md)
- [Character page header](https://kwark.space/designSystem/components/character-header.md)
- [Clip inspector](https://kwark.space/designSystem/components/clip-inspector.md)
- [Clips and grade versions](https://kwark.space/designSystem/components/grade-clip-strip.md)
- [Colour curves](https://kwark.space/designSystem/components/colour-curves.md)
- [Colour wheels](https://kwark.space/designSystem/components/colour-wheels.md)
- [Edit timeline](https://kwark.space/designSystem/components/edit-timeline.md)
- [Index card](https://kwark.space/designSystem/components/index-card.md)
- [Looks and LUTs](https://kwark.space/designSystem/components/look-picker.md)
- [Loudness meter](https://kwark.space/designSystem/components/loudness-meter.md)
- [Marker list](https://kwark.space/designSystem/components/marker-list.md)
- [Mixer](https://kwark.space/designSystem/components/mixer.md)
- [Node graph](https://kwark.space/designSystem/components/node-graph.md)
- [Outline board](https://kwark.space/designSystem/components/outline-board.md)
- [Parametric EQ](https://kwark.space/designSystem/components/parametric-eq.md)
- [Playhead and scrubber](https://kwark.space/designSystem/components/playhead.md)
- [Production calendar](https://kwark.space/designSystem/components/production-calendar.md)
- [Quick note](https://kwark.space/designSystem/components/quick-note.md)
- [Screenplay elements](https://kwark.space/designSystem/components/screenplay-elements.md)
- [Screenplay page](https://kwark.space/designSystem/components/screenplay-page.md)
- [Script timeline](https://kwark.space/designSystem/components/script-timeline.md)
- [Shot card](https://kwark.space/designSystem/components/shot-card.md)
- [Sound tracks](https://kwark.space/designSystem/components/sound-tracks.md)
- [Stripboard strip](https://kwark.space/designSystem/components/stripboard-strip.md)
- [Timecode display](https://kwark.space/designSystem/components/timecode.md)
- [Transport bar](https://kwark.space/designSystem/components/transport-bar.md)
- [Video scopes](https://kwark.space/designSystem/components/video-scopes.md)

### AI and authorship

- [Agent activity](https://kwark.space/designSystem/components/agent-activity.md)
- [Agent plan](https://kwark.space/designSystem/components/agent-plan.md)
- [AI consent prompt](https://kwark.space/designSystem/components/ai-consent.md)
- [AI result review](https://kwark.space/designSystem/components/ai-review.md)
- [AI undo history](https://kwark.space/designSystem/components/ai-undo-entry.md)
- [Prompt input](https://kwark.space/designSystem/components/prompt-input.md)
- [Provenance label](https://kwark.space/designSystem/components/provenance-label.md)
- [Revision mark](https://kwark.space/designSystem/components/revision-mark.md)
- [Suggestion panel](https://kwark.space/designSystem/components/suggestion-panel.md)

### Collaboration

- [Avatar](https://kwark.space/designSystem/components/avatar.md)
- [Board column](https://kwark.space/designSystem/components/board-column.md)
- [Comment pin](https://kwark.space/designSystem/components/comment-pin.md)
- [Comment reaction](https://kwark.space/designSystem/components/comment-reaction.md)
- [Notification bell](https://kwark.space/designSystem/components/notification-bell.md)
- [Presence cursor](https://kwark.space/designSystem/components/presence-cursor.md)
- [Research card](https://kwark.space/designSystem/components/research-card.md)
- [Script revision diff](https://kwark.space/designSystem/components/script-revision-diff.md)
- [Version history](https://kwark.space/designSystem/components/version-history.md)

## Rules for agents

> **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](https://kwark.space/designSystem/kits/screenwriting.md), [Scheduling and call sheets](https://kwark.space/designSystem/kits/scheduling-and-call-sheets.md), [Editing](https://kwark.space/designSystem/kits/editing.md), and [Building with agents](https://kwark.space/designSystem/agents/index.md) 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
