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

Kwark's design system covers foundations (colour, type, radius, elevation, spacing, layout, motion, icons), components with usage, style, code, accessibility and agent rules, patterns for creative tools, and the method Kwark uses to decide what to build.

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