# Kwark Design System > The design system behind Kwark, the story workspace for filmmakers. Written once, published for people and for the agents that build with them. Every page on https://kwark.space/designSystem links to its Markdown twin. Read AGENTS.md first: it holds the rules an agent must follow when it writes Kwark UI. Tokens are in tokens.json (DTCG 2025.10 values with exact CSS in org.kwark.css extensions) and kwark.css. ## Start here - [AGENTS.md](https://kwark.space/designSystem/AGENTS.md): the rules, in one file - [tokens.json](https://kwark.space/designSystem/tokens.json): every token, light, dark and the five writing rooms - [components.json](https://kwark.space/designSystem/components.json): every component, its parts, tokens, rules and React import - [kwark.css](https://kwark.space/designSystem/kwark.css): tokens and framework-free component styles ## Getting started - [About the system](https://kwark.space/designSystem/about.md): What the Kwark Design System is, who it is for, what is inside, how it is versioned and what the status labels on each page mean. - [What sets Kwark apart](https://kwark.space/designSystem/what-sets-kwark-apart.md): Ten things this system does that a general-purpose design system does not, most of them not about how the interface looks. Each one links to the rule, the decision or the file that proves it. - [Designing with the system](https://kwark.space/designSystem/designing.md): How a designer works with the Kwark system - foundations first, then components and patterns, the journey before any build, a decision record for every choice and a review with screenshots. - [Developing with the system](https://kwark.space/designSystem/developing.md): How to use kwark.css and tokens.json in any codebase, which React components exist in the Kwark app and where to import them, the tests that keep the code inside the system, and how to theme with dark mode, writing rooms and a project accent. - [Contributing](https://kwark.space/designSystem/contributing.md): How to propose a change to the Kwark system, write the decision record, get it reviewed, and what every control must meet before it is called done. - [Releases](https://kwark.space/designSystem/releases.md): What is in each version of the Kwark Design System, what changed, what is known to be missing, and what comes next. ## Basics - [Colour](https://kwark.space/designSystem/foundations/color.md): Colour in Kwark is a set of roles. Components ask for the page, the surface or the accent, and the theme, the room or the project decides what that is. - [Typography](https://kwark.space/designSystem/foundations/typography.md): Three faces with three jobs, six sizes, and a screenplay page measured against printed scripts down to the character. What to set, at what size, and what never to shrink. - [Radius](https://kwark.space/designSystem/foundations/radius.md): Four corners, each for one kind of thing, a rule for corners inside corners, and the paper that is never rounded more than paper is. - [Elevation](https://kwark.space/designSystem/foundations/elevation.md): Kwark is flat. Depth is a line and a step in tone; a shadow is only for something that floats above the page, and the layers it floats on are numbered once. - [Spacing](https://kwark.space/designSystem/foundations/spacing.md): Six steps from 4 to 32, two densities (a desk and a thumb), a 16px phone gutter, and the room a phone page keeps free at its foot. - [Layout](https://kwark.space/designSystem/foundations/layout.md): Where things go on a phone, a sideways phone, a tablet, a desk and a television, decided by one shared compact query, with the screenplay page at the centre of every one. - [Motion](https://kwark.space/designSystem/foundations/motion.md): Motion in Kwark answers something a person did, lasts 120 to 320 milliseconds, eases out, and stops when reduced motion is on. Nothing moves on its own. - [Iconography](https://kwark.space/designSystem/foundations/iconography.md): One icon pack, three sizes, one stroke, and a word beside almost every icon. Which glyph each Kwark module uses, which glyphs may stand alone, and what a chevron promises. ## Foundations - [Foundations](https://kwark.space/designSystem/foundations.md): The decisions every Kwark screen is built on, from the six type sizes to the reason the editor never glows. Read these before you draw a component. - [Design principles](https://kwark.space/designSystem/foundations/principles.md): The rules Kwark decides by, each with its reason, what it changes on screen, where it shows in the app and the trade-off it settles. - [Accessibility](https://kwark.space/designSystem/foundations/accessibility.md): WCAG 2.2 AA is the floor. This page gives Kwark's contrast per role, the keyboard map for the screenplay, timeline and boards, focus, screen readers, targets, motion, zoom, media and the checks every change must pass. - [Inclusive design](https://kwark.space/designSystem/foundations/inclusive-design.md): Who Kwark is for, what each of them stands to lose, and how Kwark decides on their behalf: students from 13, cheap phones on slow networks, offline work, many languages, calm for every kind of mind, privacy and cost. - [Writing rooms](https://kwark.space/designSystem/foundations/rooms.md): The screenplay editor's five rooms (Studio, Daylight, Paper, Lamplight, Midnight): what each is made of, how every colour in the editor is worked out from it, the legibility maths, and the rules for building inside one. - [Writing systems](https://kwark.space/designSystem/foundations/writing-systems.md): How Kwark writes a screenplay in more than one language and script: the four language modes, phonetic typing on an English keyboard, fonts per script, right-to-left lines, print and PDF limits, numerals, case and sorting. - [Content](https://kwark.space/designSystem/foundations/content.md): Kwark's voice and tone: calm, plain and film-literate. How Kwark talks about saving and errors, the film words it uses and how, capitalisation, numbers, dates and times for crews, and names and roles. - [UX writing](https://kwark.space/designSystem/foundations/ux-writing.md): The micro-copy handbook. How Kwark words buttons, labels, errors, empty states, confirmations, toasts, notifications, first runs, settings and machine suggestions, with before and after tables from real Kwark strings and a word list. - [AI and authorship](https://kwark.space/designSystem/foundations/ai-and-authorship.md): Kwark's stance on machines and the writer's work. What a machine may and may not do in Kwark, how anything it proposes is marked, sourced, consented to and undone, what happens to the work's privacy, and why Kwark chose the margin mark over the industry's sparkles and glows. - [Data visualisation](https://kwark.space/designSystem/foundations/data-visualization.md): The charts Kwark draws (the timeline, the story spine, the stripboard, the calendar, Dailies, the budget's top sheet), the colours they use and in what order, labels over legends, accessible alternatives, and the one chart Kwark never draws: a score for the writing. ## For agents - [For agents](https://kwark.space/designSystem/agents/index.md): Kwark is written for two readers, people and the agents that build with them. Start here to connect Claude Code, Cursor, Codex or Gemini to the system in three steps. - [AI context files](https://kwark.space/designSystem/agents/ai-context.md): The files an agent can load - llms.txt, llms-full.txt, the markdown twins, AGENTS.md, tokens.json and components.json - what each is for, how to load it, and which one to use for which task. - [Prompt library](https://kwark.space/designSystem/agents/prompts.md): Copy-ready prompts for building with the Kwark system - a screen, a review, UX copy, a phone layout, a new component, a decision record and a readiness test - each with the context files it needs. - [Design-to-code handoff](https://kwark.space/designSystem/agents/handoff.md): How Kwark hands a design to whoever builds it, a person or an agent - a spec that names components and tokens, covers phone and desktop, every state, every word, accessibility and edge cases, with a template to download. - [MCP server](https://kwark.space/designSystem/agents/mcp.md): Install the Kwark design MCP server in Claude Code, Cursor, Codex or Gemini so an agent can search the docs, read any page, look up components and tokens, and audit its own code against the system. - [Skills](https://kwark.space/designSystem/agents/skills.md): Fourteen downloadable agent skills that teach Claude (and any agent that reads SKILL.md files) to build, review, write copy, hand off, record decisions and start a creative app the Kwark way. - [Readiness tests](https://kwark.space/designSystem/agents/readiness.md): How to test whether an agent really follows the Kwark system - the readiness test at the end of each page, how to run and grade it in a fresh conversation, what a reliable answer looks like, and every page that has one. - [AI-ready roadmap](https://kwark.space/designSystem/agents/roadmap.md): Kwark's own model for a creative-app team adopting the system - six stages, seventeen steps, a "ready enough" line and an AI readiness check for each, statuses instead of scores, and the order the steps depend on. ## Kwark method - [Kwark method](https://kwark.space/designSystem/method.md): How Kwark goes from a filmmaker's problem to a shipped screen, the tests every decision passes, and where each step is written down. - [UX before build](https://kwark.space/designSystem/method/ux-before-build.md): On any feature that spans more than one screen, walk the person's journey and agree its shape by showing it, before a line of code is written. - [Decision records](https://kwark.space/designSystem/method/decision-records.md): Every decision a person can see or feel gets one numbered record that says the problem, the options, why this one, and what would make us remove it. - [Competitors are the floor](https://kwark.space/designSystem/method/competitors-are-the-floor.md): Parity with other writing and production tools is the minimum. Every plan leads with what none of them does, and a competitor review is how Kwark finds both. - [Structure, not teaching](https://kwark.space/designSystem/method/structure-not-teaching.md): Every field in Kwark feeds a real artefact a person can use. Kwark never coaches, quizzes or explains film theory, and every piece of structure can be switched off. - [Discovery](https://kwark.space/designSystem/method/discovery.md): How Kwark decides what is worth building for a person: who it is for, the real job, the assumptions that could be wrong, and the smallest test, without inventing research it does not have. - [Specs and handoff](https://kwark.space/designSystem/method/specs-and-handoff.md): How a Kwark feature is specified so that anyone can build it, phone first, with every state and every word written, and with the paper artefact and the digital one designed as one act. - [Review and quality](https://kwark.space/designSystem/method/review-and-quality.md): What "done" means for a Kwark change: built from the system, looked at in screenshots, reviewed by separate supervisors, tested, inside the free-tier budget, then shipped to main one feature at a time. - [Product skills](https://kwark.space/designSystem/method/product-skills.md): The product-management and design skills Kwark uses, what each is for, when it is the right tool, and how to run it with an AI agent so the answer stays true to Kwark's rules. ## Components - [Component catalogue](https://kwark.space/designSystem/components.md): 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. - [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. - [Button group](https://kwark.space/designSystem/components/button-group.md): A few commands on the same object, joined. On a locked script each one says the scene number it will create. - [Copy field](https://kwark.space/designSystem/components/copy-field.md): A link that leaves the room: the call sheet’s address, what revision it shows, who can open it, and one button that copies it and says so. - [Floating action button](https://kwark.space/designSystem/components/floating-action.md): One labelled action floating at the foot of a phone screen, for a surface that has no floating dial. It names where the new thing will land. - [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. - [Icon button](https://kwark.space/designSystem/components/icon-button.md): A button that is only a glyph. Allowed for universal symbols, and it always carries a name. - [Split button](https://kwark.space/designSystem/components/split-button.md): One action you run all the time, joined to the few close variants of it. The left half runs the default; the chevron half opens the formats. - [Text button](https://kwark.space/designSystem/components/text-button.md): An icon and a word, used in headers, toolbars and sheets. A chevron means it opens something. - [Date picker](https://kwark.space/designSystem/components/date-picker.md): A month that knows the shoot: shooting days numbered Day 1 to Day 24, days off, recces and today, so a date is chosen as “Day 7 of 24”, not just the 23rd. - [File uploader](https://kwark.space/designSystem/components/file-upload.md): Bring in a screenplay from wherever it was written: drop a Final Draft, Fountain, Celtx, Word or PDF file, watch it read, and see what it read before it lands. - [Number stepper](https://kwark.space/designSystem/components/number-stepper.md): A number you nudge or type. It counts page length in eighths the way the stripboard does, takes like a slate, and keeps “not counted” apart from zero. - [Search field](https://kwark.space/designSystem/components/search-field.md): Find words in the screenplay. Results read like the script: scene numbers in both margins, the heading in Courier, the match marked in the line. - [Slider](https://kwark.space/designSystem/components/slider.md): Two sliders for film work: a playhead you scrub along a frame ruler with the timecode above it, and a fader with a unity detent and an exact value beside it. - [Text input](https://kwark.space/designSystem/components/text-input.md): One line of text with a visible label, an optional hint and a plain-language error. - [Textarea](https://kwark.space/designSystem/components/textarea.md): Several lines of plain text, such as a logline, notes or a description, that grow with what is written and keep the height a person sets. - [Time picker](https://kwark.space/designSystem/components/time-picker.md): A call time, the way the call sheet prints it: large 24-hour figures, the shoot’s time zone, quick picks for unit call and sunrise, and +1 when the day runs past midnight. - [Checkbox and radio](https://kwark.space/designSystem/components/checkbox-and-radio.md): Checkboxes pick any number; radios pick exactly one, with every option in sight. Native boxes in the project’s accent, labels that say what is true when checked. - [Chip](https://kwark.space/designSystem/components/chip.md): A filter or a choice you can switch on and off. Not a status and not a button. - [Colour picker](https://kwark.space/designSystem/components/colour-picker.md): Ten project colours, each one swatch with two jobs: the colour that acts and its lighter tint that is merely lit. - [Combobox](https://kwark.space/designSystem/components/combobox.md): A field that suggests answers but always keeps what you type. Choices are a help, never a gate. - [Icon toggle](https://kwark.space/designSystem/components/icon-toggle.md): A pair of glyph buttons that switch a view, such as poster or list on Home. Pressed is a filled square; each says its name. - [Multiselect](https://kwark.space/designSystem/components/multiselect.md): Choose several from a long list, such as the characters in a scene, each carrying its board number from the stripboard, with a filter and a way to add a new one. - [Removable tag](https://kwark.space/designSystem/components/removable-tag.md): A coloured pencil mark you can lift: active filters in their calendar colours, and breakdown elements in their department pencils, each with one clear way to remove it. - [Segmented control](https://kwark.space/designSystem/components/segmented-control.md): Two or three mutually exclusive views or modes, all in sight, chosen with one press and moved through with the arrow keys. - [Select](https://kwark.space/designSystem/components/select.md): Pick one value from four to fifteen, with the phone’s own picker. A native select in Kwark’s box, with a drawn chevron and every state. - [Switch](https://kwark.space/designSystem/components/switch.md): Turns a setting on or off the moment it is pressed. In Kwark it lives in a settings row with a title, what it does, and whether it is for this project or all your scripts. - [Account menu](https://kwark.space/designSystem/components/account-menu.md): Who you are, whose work you are looking at, and whether your work is safe: the account panel and the workspace switcher. - [Bottom navigation](https://kwark.space/designSystem/components/bottom-navigation.md): A phone tab bar for a companion screen with three to five equal destinations. Kwark’s own phone chrome does not use one. - [Breadcrumb](https://kwark.space/designSystem/components/breadcrumb.md): Keep the project, phase and active module visible as a filmmaker moves between rooms. - [Command palette](https://kwark.space/designSystem/components/command-palette.md): One field that goes anywhere in the film: type 12 for Scene 12, Mira for the character, p26 for page 26, or the name of any command from the five menus. - [Link](https://kwark.space/designSystem/components/text-link.md): Words that take you somewhere. A reference link points at a record in the film and carries its number, so "Scene 12" goes to the right Scene 12 even after the script is reordered. - [Page header](https://kwark.space/designSystem/components/page-header.md): One line on a phone: back, a one-word title, and the labelled Menu. - [Pagination](https://kwark.space/designSystem/components/pagination.md): Moves through a script page by page, each page on its revision paper, A-pages included. A plainer form steps through long lists of records. - [Progress steps](https://kwark.space/designSystem/components/stepper.md): The steps of one piece of work, in order, each with what it already holds: Shots, Blocking, Storyboard, Animatic. - [Side navigation](https://kwark.space/designSystem/components/side-navigation.md): A quiet rail of a project’s modules, grouped the way the breadcrumb’s module menu groups them. - [Tabs](https://kwark.space/designSystem/components/tabs.md): Sections of one thing, side by side. Never steps in a process. - [Top bar](https://kwark.space/designSystem/components/top-bar.md): The one line at the top of the project library: the Kwark wordmark, whose stories these are, and the two things people do here. - [Tree view](https://kwark.space/designSystem/components/tree-view.md): The film as Act › Sequence › Scene, opened and closed by level. Each scene shows its number, its stripboard colour and its length in eighths. - [Banner](https://kwark.space/designSystem/components/banner.md): A persistent message about the whole page: read-only, offline, out of sync. - [Callout](https://kwark.space/designSystem/components/callout.md): A bordered note at the top of a working page: what someone should know before they trust what is below it. - [Empty state](https://kwark.space/designSystem/components/empty-state.md): What a screen says before there is anything on it: what goes here, and the one way to start. - [Feedback control](https://kwark.space/designSystem/components/feedback-control.md): Asks whether one of Kwark’s own tools helped: Useful or Not useful, with an optional note. Never placed on a person’s writing. - [Inline notice](https://kwark.space/designSystem/components/inline-notice.md): One fixable thing, said next to the field it is about, with the fix beside it, and what the paper will say until it is fixed. - [Offline state](https://kwark.space/designSystem/components/offline-state.md): How Kwark says work is kept on this device: a tag on the project, a word at the corner, and a banner only when a choice is needed. - [Page loader](https://kwark.space/designSystem/components/cinematic-loader.md): Kwark’s one loader: the page’s own background at once, and a small Kwark mark only if the wait passes 0.4 seconds. - [Progress and loading](https://kwark.space/designSystem/components/progress.md): Shows how much of a known job is done, in a bar and in figures: pages exported, folders imported. Kwark’s is the 2px bar of the import toast, with each folder on its own line. - [Skeleton](https://kwark.space/designSystem/components/skeleton.md): Grey bars in the exact shape of what is coming. The screenplay skeleton is a page on its real margins: heading, action, a centred cue, an indented speech, and scene numbers in both margins. - [Spinner](https://kwark.space/designSystem/components/spinner.md): The three quarks of the Kwark mark taking turns, for work whose length cannot be measured. Nothing for the first 0.4 seconds, and always with words. - [Status dot](https://kwark.space/designSystem/components/status-dot.md): A small shape and a word for a state: saved, on this device, offline. Its film use is the call sheet’s read receipts, where each crew member is confirmed, read or not yet reached. - [Sync status](https://kwark.space/designSystem/components/sync-status.md): One quiet word that says whether the work is safe: Saved, Saving…, Saved on this device, Changed elsewhere. - [Toast](https://kwark.space/designSystem/components/toast.md): Give a short receipt for an action, with enough time to dismiss it or undo it. - [Context menu](https://kwark.space/designSystem/components/context-menu.md): Right-click or long-press a project, a scene or a card for the same actions its ⋯ button offers, at the pointer. - [Dialog](https://kwark.space/designSystem/components/dialog.md): Stops the work to ask one question or collect a small form. Use rarely. - [Drawer](https://kwark.space/designSystem/components/drawer.md): A column from the right for the details of what you are working on. Kwark has two: the modal drawer for properties, and the comment dock that keeps the script readable beside it. - [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. - [Popover](https://kwark.space/designSystem/components/popover.md): A small card anchored to what you pointed at, with the facts you need about it and one or two ways to go further. The scene popover gives its length in eighths, its cast and its shooting day. - [Sheet](https://kwark.space/designSystem/components/sheet.md): A panel from the bottom of a phone screen for menus, filters and short tasks. - [Tooltip](https://kwark.space/designSystem/components/tooltip.md): A name on hover and focus. Kwark uses the browser’s title today; the drawn tooltip adds a shortcut where a desk needs it. - [Accordion](https://kwark.space/designSystem/components/accordion.md): Sections a person opens one at a time when most are not needed at once. Each closed row already says its current value, so it rarely needs opening. - [Card](https://kwark.space/designSystem/components/card.md): Choose the card that matches what the filmmaker is holding: a project cover, scene card or shot. - [Divider](https://kwark.space/designSystem/components/divider.md): A 1px line where one group really ends. Two Kwark forms carry their numbers: the act break with its scene and page count, and the page break with the printed page number. - [Toolbar](https://kwark.space/designSystem/components/toolbar.md): The tools for one surface in one line, laid out like an edit bay: what is selected, the transport, the timecode, the tools, then everything else under a word. - [Badge](https://kwark.space/designSystem/components/badge.md): A short, read-only label for state: Draft, Locked, Shared, Revised. - [Budget top sheet](https://kwark.space/designSystem/components/budget-top-sheet.md): The producer's top sheet on paper, and accounts whose lines can follow a rate from Cast & Crew or Locations. - [Code block](https://kwark.space/designSystem/components/code-block.md): Exact text to copy: a file name, its language, line numbers outside the copy, and changed lines marked with an asterisk in the right margin, the way revised script pages are. - [Dailies day](https://kwark.space/designSystem/components/dailies-day.md): One frame of Dailies opened: the pages you saved that day, each a link back to the work, with the kind of work as a band. Private, on this device, and honest when the links have expired. - [Data table](https://kwark.space/designSystem/components/data-table.md): Rows people sort, select and scan: the shot list, the one-liner. Drawn checkboxes, sort arrows in the header, numbers right-aligned in tabular figures, stripboard colours on the one-liner. - [Description list](https://kwark.space/designSystem/components/description-list.md): Labelled facts about one thing, read like a camera report: roll, scene, take, lens, stop, timecode. Label left, value right in tabular figures; stacked in narrow panels. - [Element tag](https://kwark.space/designSystem/components/element-tag.md): A breakdown element as a small tab in its department's pencil colour, with an optional quantity. - [Keyboard key](https://kwark.space/designSystem/components/keyboard-key.md): Shows a key or a shortcut, in three weights: the quiet cap in the screenplay’s element strip, the raised cap on a shortcut sheet, and plain text at the end of a menu row. - [List row](https://kwark.space/designSystem/components/list-row.md): One tappable line in a list. The whole row is the target; a value or a single ⋯ sits beside it, outside the pressed area. - [Meter](https://kwark.space/designSystem/components/meter.md): A measured amount against a known limit, like a shoot day’s pages against its target. A fact, never a judgement of the work. - [Stat](https://kwark.space/designSystem/components/stat.md): The call sheet's top band as figures: Day 7 of 24, crew call, sunrise, wrap +1, pages in eighths. Big tabular numbers, a label above, one quiet line of context. - [Area chart](https://kwark.space/designSystem/components/area-chart.md): One quantity along the script with its area filled: the length of every scene from Scene 1 to Scene 58, acts marked, so the script's rhythm is visible and the area adds up to its pages. - [Bar chart](https://kwark.space/designSystem/components/bar-chart.md): Horizontal bars from zero for a few named amounts: shoot days per location, pages per act, cost by account. Names on the left, values at the bar ends, a table behind. - [Dailies frame](https://kwark.space/designSystem/components/dailies-frame.md): A week of your work as a film strip: each day a frame with up to three bands for story, prep and performance. Kind of work, never volume. - [Donut chart](https://kwark.space/designSystem/components/donut-chart.md): Two to four shares of one whole around a ring: the budget above the line, production and post, with the total in the hole and every share written beside it. - [Gantt chart](https://kwark.space/designSystem/components/gantt-chart.md): The shooting schedule as bars across shoot days: one row per location, day and night work told apart, company moves marked where the unit packs up mid-day, days off hatched. - [Line chart](https://kwark.space/designSystem/components/line-chart.md): A measure over shoot days on a quiet grid: pages shot, from the production report, against the schedule, dashed. Direct labels at the line ends, a table behind. - [Production timeline](https://kwark.space/designSystem/components/production-timeline.md): One film's dates from first draft to release in lanes: phases as bars, dates as marks, today as a line. - [Scene density heatmap](https://kwark.space/designSystem/components/heatmap.md): Who speaks in which scene: characters down the side, scenes across, four steps of one colour, the scene count at each row's end, and the scene open in the editor outlined. - [Sparkline](https://kwark.space/designSystem/components/sparkline.md): A word-sized line beside a figure: pages shot per day on the production report, the script's length draft by draft. The shape at a glance, the number in text. - [Story spine](https://kwark.space/designSystem/components/story-spine.md): The whole story at a glance above the Structure view: a band per section, a dot per beat. It measures, never judges. - [Bin](https://kwark.space/designSystem/components/bin.md): The media browser: clips by scene and day in a dense list with take, start timecode, duration, camera and the script line, or as picture thumbnails; circled takes and offline media marked in words. - [Compare viewer](https://kwark.space/designSystem/components/compare-viewer.md): Before and after on one frame: a split line you drag, labels on both sides, Split, Wipe, Side by side or Toggle, and a plain statement of the viewing transform and that this screen is not a reference. - [Lightbox](https://kwark.space/designSystem/components/lightbox.md): One reference at full size on black, with the film's frame lines laid over it to check the composition, a sprocketed strip of the set below, and Escape back to the tile. - [Location card](https://kwark.space/designSystem/components/location-card.md): A candidate place for a scene's location: photo, status from Idea to Locked, address and what it costs. - [Media grid](https://kwark.space/designSystem/components/media-grid.md): References as a contact sheet: tiles at one ratio, each named, its kind or length on the frame, the frame number under it, opening to the lightbox. - [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. - [Source and program viewers](https://kwark.space/designSystem/components/viewer-pair.md): Two viewers side by side: the clip on the left in its own clock, the sequence on the right; one is active at a time, and the edit buttons sit between them. - [Storyboard frame](https://kwark.space/designSystem/components/storyboard-frame.md): A panel on paper with an ink border at the film's aspect ratio, captioned with the shot, its words and its seconds. Board cast figures stand in for people. - [Video player](https://kwark.space/designSystem/components/video-player.md): A viewer: picture on a neutral black surround, safe-area guides, burnt-in timecode and slate, a scrub bar with the in–out range, and the compact transport. - [Waveform](https://kwark.space/designSystem/components/waveform.md): Audio as amplitude against time: a mono dialogue clip with a dB scale, selection, playhead and clipped peaks marked, and a stereo pair below; the file's format and the clips named in words. - [ADR cue list](https://kwark.space/designSystem/components/adr-cue-list.md): Lines to re-record, made from the screenplay: cue number, character, the line in screenplay type, in and out, reason, takes with the chosen one ringed, status, and the selected cue with its script context and Record. - [Audio meter](https://kwark.space/designSystem/components/audio-meter.md): Sample-peak meters in dBFS with a scale, peak hold and held peak read-outs, a clip indicator in words, stereo and 5.1 in channel order, and the 2px meter that lives in a track header. - [Breakdown page](https://kwark.space/designSystem/components/breakdown-page.md): The script marked up the way an AD does it with coloured pencils: select words, say what they are, and they go on the sheet too. - [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. - [Camera setup card](https://kwark.space/designSystem/components/camera-inspector.md): A camera position prepared for the crew: the shots it covers, the creative approach, optics, and what was actually recorded. - [Cast board](https://kwark.space/designSystem/components/cast-board.md): Every part the screenplay wrote, each opening to the people who might play it and how far each has got. - [Channel strip](https://kwark.space/designSystem/components/channel-strip.md): One track of a mixer, top to bottom in signal order: input, inserts, an EQ thumbnail, sends, pan, record, solo and mute, a fader on a dB scale beside a meter with peak hold, read-outs and the track named by character. - [Character card](https://kwark.space/designSystem/components/character-card.md): An image-first card for a character in the roster: portrait at 4:5, role, name, one line, and a ⋯ that appears on hover. - [Character page header](https://kwark.space/designSystem/components/character-header.md): One line across the character page: back, portrait, name, the save word, Share and More. Pages in one list beside it. - [Clip inspector](https://kwark.space/designSystem/components/clip-inspector.md): Properties of the selected clip in dense rows: scrubbable numbers with units, a keyframe diamond per row, reset per section, and the slate and script line the clip came from. - [Clips and grade versions](https://kwark.space/designSystem/components/grade-clip-strip.md): The grading timeline as pictures: numbered clips with timecode, Graded or Not graded in words, the version in use, the scene's grade note, and the clip's versions including a machine suggestion that is never applied on its own. - [Colour curves](https://kwark.space/designSystem/components/colour-curves.md): Custom curves with Y, R, G and B channels over a histogram, and hue-versus-saturation with its hue band: a plot with a grid, control points, and the input and output of the selected point in numbers. - [Colour wheels](https://kwark.space/designSystem/components/colour-wheels.md): Primary correction: lift, gamma, gain and offset as four wheels with a hue ring, a puck, a master slider and Y R G B read-outs, under one row of contrast, pivot, saturation, temperature and tint. - [Edit timeline](https://kwark.space/designSystem/components/edit-timeline.md): The multitrack sequence: ruler in timecode, V2/V1/A1–A4 with patch, target, lock, mute and solo, clips named by slate with picture and waveforms, dissolve, trim handle, snapping, script-linked markers and one playhead. - [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. - [Looks and LUTs](https://kwark.space/designSystem/components/look-picker.md): Choose a show look or a conversion LUT by its before-and-after on the actual frame, each named with source, destination, size and format; the Look Book's references sit alongside and apply nothing. - [Loudness meter](https://kwark.space/designSystem/components/loudness-meter.md): Integrated loudness in LUFS against the target the project chose, with momentary and short-term bars, loudness range, true peak, the time measured and a history graph with the target band. - [Marker list](https://kwark.space/designSystem/components/marker-list.md): Every marker in the sequence by timecode, with colour and number, duration, the note or the screenplay line it points to, and who left it. - [Mixer](https://kwark.space/designSystem/components/mixer.md): Eight track strips, two stem buses and the master, side by side and scrolling sideways: dialogue named by character, effects and music by kind, buses and master set apart. - [Node graph](https://kwark.space/designSystem/components/node-graph.md): The order of operations in a grade: numbered nodes with a picture of their result, serial and parallel paths, a mixer, key and window badges, and the selected node outlined. - [Outline board](https://kwark.space/designSystem/components/outline-board.md): The Board view of the Outline: one column per section, cards in order, a story spine above. - [Parametric EQ](https://kwark.space/designSystem/components/parametric-eq.md): A frequency response on a log scale from 20 Hz to 20 kHz over the live spectrum: numbered band handles you drag, the selected band's own shape, and a table of type, frequency, gain and Q. - [Playhead and scrubber](https://kwark.space/designSystem/components/playhead.md): One shared position in time: a coral pentagon head on a timecode ruler and a 1px line through every track, with the in–out range, the shuttle speed while playing and the time under it while scrubbing. - [Production calendar](https://kwark.space/designSystem/components/production-calendar.md): The calendar for artists: a week time grid with the day job dimmed, a month, and What is next, in seven film categories. - [Quick note](https://kwark.space/designSystem/components/quick-note.md): A pen in the corner and a card to write on that leaves the page where it is. The note remembers where it came from. - [Screenplay elements](https://kwark.space/designSystem/components/screenplay-elements.md): Scene heading, action, character, parenthetical, dialogue and transition, each with its printed indent and width. - [Screenplay page](https://kwark.space/designSystem/components/screenplay-page.md): The page a writer writes on: US Letter geometry, 12pt Courier, one 16px grid, and the same line breaks as the printed PDF. - [Script timeline](https://kwark.space/designSystem/components/script-timeline.md): How long the script will run and where the minutes go: scenes in proportion, a dashed target, a ring on the scene you are in. On a phone, a 22px strip. - [Shot card](https://kwark.space/designSystem/components/shot-card.md): One shot: its name (1A), what is in the frame, framing in industry terms, and the lines of script it covers. - [Sound tracks](https://kwark.space/designSystem/components/sound-tracks.md): The sound session's timeline: track headers with record arm, input monitor, solo, mute and lock; clips with waveforms, fade handles, a clip-gain line with breakpoints, a crossfade, and a take recording live. - [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. - [Timecode display](https://kwark.space/designSystem/components/timecode.md): The clock of picture and sound: HH:MM:SS:FF in Poppins tabular figures, labelled with which clock it is and its frame rate, with a semicolon for drop-frame and typed relative entry. - [Transport bar](https://kwark.space/designSystem/components/transport-bar.md): Mark in and out, step, play backwards and forwards, loop, marker and match frame, in one 32px row; with the J/K/L shuttle gauge that shows speed and direction. - [Video scopes](https://kwark.space/designSystem/components/video-scopes.md): Waveform, RGB parade, vectorscope with 75% targets and the skin-tone line, and an RGB histogram, on black, with labelled scales, legal-range lines and a cursor read-out in code values. - [Agent activity](https://kwark.space/designSystem/components/agent-activity.md): What the agent is doing right now, step by step, with a Stop that is always on screen and keeps whatever is already proposed. - [Agent plan](https://kwark.space/designSystem/components/agent-plan.md): Before an agent acts, it lists its steps, what each one reads and what each one changes. The person edits, skips or approves each step. - [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. - [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 undo history](https://kwark.space/designSystem/components/ai-undo-entry.md): A line in the project’s history for every machine proposal a person used: what changed, from what, who accepted it, and Undo. - [Prompt input](https://kwark.space/designSystem/components/prompt-input.md): Ask Kwark to find, measure or carry something in the project, with chips that show exactly what it will look at. - [Provenance label](https://kwark.space/designSystem/components/provenance-label.md): Says where a proposal came from, in words, and stays with it until a person makes it their own. - [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. - [Avatar](https://kwark.space/designSystem/components/avatar.md): A person: their photo or initials, in a colour that stays theirs everywhere. Beside a name it carries their film role; in a stack it shows who else is here and where. - [Board column](https://kwark.space/designSystem/components/board-column.md): A kanban column for things people pass between them: a department's requests, notes waiting for an answer. - [Comment pin](https://kwark.space/designSystem/components/comment-pin.md): Marks where a conversation is attached to the work. - [Comment reaction](https://kwark.space/designSystem/components/comment-reaction.md): Answer a comment without writing a reply: Seen, Agreed or Let’s talk, with the names of who said so. No counts to chase, no emoji. - [Notification bell](https://kwark.space/designSystem/components/notification-bell.md): Appears only while someone is asking to join your project, and lets you answer them by film role without leaving the page. - [Presence cursor](https://kwark.space/designSystem/components/presence-cursor.md): Other people's pointers and carets over the work, each in their colour with their name. Never between someone and the work. - [Research card](https://kwark.space/designSystem/components/research-card.md): A piece of research on a writer's board: its kind, title, a few lines, and whether it is private or shared by someone. - [Script revision diff](https://kwark.space/designSystem/components/script-revision-diff.md): Lock the script, issue coloured revisions in the industry order, and see what changed since the last colour. - [Version history](https://kwark.space/designSystem/components/version-history.md): Named, saved versions newest first, compared with today, restored after the current version is saved. ## Patterns - [Patterns](https://kwark.space/designSystem/patterns.md): How Kwark solves the problems every screen meets, from saving and sync to sharing by film role, each grounded in a decision and shown in real Kwark UI. - [AI assistance](https://kwark.space/designSystem/patterns/ai-assistance.md): How machine help works in Kwark, step by step. A machine may measure the work, find things in it, carry it into production, move the writer's own words, convert how they are typed, read it aloud, or prepare it for a tool the person chooses. Every proposal is marked, sourced, offered one at a time, undoable and never a judgement. - [Saving and sync](https://kwark.space/designSystem/patterns/saving-and-sync.md): Kwark saves as you write, keeps every change on the device until the cloud has it, never lets one device silently overwrite another, and says where the work is in one calm word. - [Errors](https://kwark.space/designSystem/patterns/errors.md): When something goes wrong, Kwark says the state of the work first, then what happened and what to do, in one calm sentence, and never shows raw system text. - [Empty states](https://kwark.space/designSystem/patterns/empty-states.md): An empty screen in Kwark says what goes here, where it comes from, and the one way to fill it, without jokes, illustrations, coaching or guilt. - [Forms](https://kwark.space/designSystem/patterns/forms.md): Kwark forms ask for as little as possible, let everything wait, save as you go where they can, and say where each answer will end up. - [Navigation](https://kwark.space/designSystem/patterns/navigation.md): Kwark has one ladder (Home, project, phase, module, page), one breadcrumb that switches between neighbours, two phases named Write and Prepare to shoot, and a project home that orients before it sends you anywhere. - [Phones](https://kwark.space/designSystem/patterns/phones.md): On a phone Kwark gives the screen to the work: one 44px header line, content by the first fifth of the screen, one floating button for comments, notes and account, rows without buttons, and thumb-sized targets everywhere. - [Menus and shortcuts](https://kwark.space/designSystem/patterns/menus-and-shortcuts.md): The screenplay has five desktop-grade menus (File, Edit, Format, View, Help) with one home for every command, real shortcuts shown beside them, switches for what stays on, and the same list as a drill-down sheet on a phone. - [Destructive actions](https://kwark.space/designSystem/patterns/destructive-actions.md): Kwark prefers Undo to "Are you sure?", keeps deleted stories in the trash for 30 days, and asks only before something that cannot be undone or that changes what other people can see, naming exactly what will go. - [Sharing and roles](https://kwark.space/designSystem/patterns/sharing-and-roles.md): Sharing in Kwark is one panel, by film role, safe by default. New people are Readers, the request link is off, every person is named and removable, and because Kwark sends no email the owner sends the invite themselves. - [Collaboration](https://kwark.space/designSystem/patterns/collaboration.md): Kwark shows who else is here only when someone is, draws their pointer where it lands on the page, keeps comments anchored to what they are about, and never lets two sessions silently overwrite each other. - [Loading](https://kwark.space/designSystem/patterns/loading.md): Kwark keeps the page's frame steady while work arrives, says what it is opening in plain words, shows progress only when it is long enough to matter, and never lets a half-loaded screen save over real work. - [Search and filter](https://kwark.space/designSystem/patterns/search-and-filter.md): Kwark lets people find things the way they would say them, keeps filters visible and easy to clear, and folds find, filter and sort into one labelled control on a phone. - [First run](https://kwark.space/designSystem/patterns/first-run.md): A new visitor's first frame says what Kwark does and offers one way to begin; no account is needed, a guest keeps their place through sign-in, and nothing about the first minutes counts, tours or nags. - [Print and export](https://kwark.space/designSystem/patterns/print-and-export.md): Everything a crew works from prints as the paper they already use and exports as structured data from the same copy; call sheets issue as numbered, frozen revisions; scripts in Indian languages print with correctly shaped text. - [Notifications](https://kwark.space/designSystem/patterns/notifications.md): Kwark tells people only what they need to act on or would want to know, in the place it concerns, quietly; it sends no email, has no notification feed, and never exists to bring people back. - [Settings](https://kwark.space/designSystem/patterns/settings.md): Anything chosen once and kept lives in one Settings window, grouped by what it changes, each row saying what it does and whether it is for this project or all your scripts; optional features start off, and every change applies at once. - [Onboarding without teaching](https://kwark.space/designSystem/patterns/onboarding-without-teaching.md): Kwark helps people find its own controls when they look for them, through plain names, honest empty states, a sample film and an optional tour, and never teaches them how to write or make a film. ## Creative app kits - [Creative app kits](https://kwark.space/designSystem/kits.md): Everything a team needs to build a screenwriting, editing, storyboard, scheduling, sound, grading or production app on Kwark: screens, components, domain conventions, keyboard maps, phone rules, AI rules and a starter prompt. - [Screenwriting](https://kwark.space/designSystem/kits/screenwriting.md): Build a writing surface whose page on screen is the printed page, with the elements, revisions, outline and timeline a working screenwriter expects, and nothing that judges the work. - [Editing](https://kwark.space/designSystem/kits/editing.md): Build a picture editor or review tool on Kwark: a bin that knows the script, source and program viewers, a multitrack timeline with one coral playhead, timecode written correctly, and the keyboard editors already use. - [Storyboard and shots](https://kwark.space/designSystem/kits/storyboard-and-shots.md): Build shot planning the way a director and DP think about it: shots named by scene and letter, framing in industry terms, coverage lined on the script, boards at the film's aspect ratio, setups for the crew, and an animatic. - [Scheduling and call sheets](https://kwark.space/designSystem/kits/scheduling-and-call-sheets.md): Build the first AD's tools: a stripboard in pages and eighths with the four paper colours, shooting days, day out of days, and call sheets issued as numbered, frozen revisions that print, save as PDF and download as CSV. - [Sound](https://kwark.space/designSystem/kits/sound.md): Build a sound session or dubbing tool on Kwark: tracks named by character, waveforms with fades and clip gain, a mixer in signal order, loudness against the target the project chose, and ADR cues made from the screenplay. - [Colour grading](https://kwark.space/designSystem/kits/colour-grading.md): Build a grading or dailies colour tool on Kwark: a neutral viewer with before and after, scopes that measure, primaries with numbers, a node graph that shows order, clips with versions, and looks named by their colour spaces. - [Production office](https://kwark.space/designSystem/kits/production-office.md): Build the producer's and line producer's tools on Kwark: a marked-up breakdown that writes its own sheets, cast and locations that feed the budget, paperwork that remembers when it was checked, and sharing by film role. - [Any creative app](https://kwark.space/designSystem/kits/any-creative-app.md): Carry Kwark's approach into another craft, such as music, animation, theatre, comics, games or podcasts, without importing film-specific assumptions: find the craft's own paper, its own units and its own conventions, then build them as one act. ## Resources - [Guides](https://kwark.space/designSystem/guides.md): Longer guides on the hardest problems in creative tools, written from the decisions behind Kwark. All are coming soon; this page gives each one's outline and who it is for. - [Frequently asked questions](https://kwark.space/designSystem/faq.md): Short answers about using the Kwark system - licensing (MIT code, CC BY writing), Figma, React or plain CSS, using it outside film, agents, status labels, contributing and what is not covered yet. - [Licence](https://kwark.space/designSystem/licence.md): What you may copy, ship and change, and what stays Kwark's. Code is MIT, the writing is CC BY 4.0, and the Kwark name and brand are not licensed.