Kwark. Design System
Open Kwark

Empty states

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.

Patterns

No call sheets yet

A call sheet is made for each shooting day, and the days are built from the screenplay's scenes. Write or import the script, then schedule its days.

The problem

A producer opens Kwark on Monday to make the first call sheet for a five-day shoot. The Call sheets screen is empty. If it shows a cartoon clapperboard and “Nothing to see here”, she learns nothing: she does not know whether call sheets are made here, whether she has to set something up first, or whether something is broken.

Empty screens are where people decide whether a tool understands their work. In Kwark they are also where the one-script promise is either visible or not: a call sheet is empty because the schedule is, and the schedule is empty because the screenplay has no scenes yet. The empty state is the place to say so.

Kwark’s answer

An empty state answers three questions, in this order:

  1. What goes here? The heading names the thing: “No call sheets yet”, “No cast yet”, “No beats yet”.
  2. Where does it come from? One or two sentences that say how this fills, especially when it fills from somewhere else: “The schedule is built from the screenplay’s scene headings.”
  3. What can I do now? One action, named with a verb and the object. If the thing fills from elsewhere, the action takes them there.

It is calm and factual. It does not celebrate, apologise, joke or teach. Decision 0004 keeps coaching out of it: the empty outline card once asked “What does an ordinary day look like before anything changes?”; since 4 November it says “Add words…”.

Five kinds of empty

Kind What the person needs Example
Nothing made yet What goes here and the way to start “No locations yet. Locations you add here appear on every call sheet that uses them.” Add location
Fills from elsewhere Where it comes from, and a route there “No scenes to schedule yet. The schedule is built from the screenplay’s scene headings. Write or import the script, and every scene arrives here as a strip.”
Nothing matches That the search or filter is the cause, and how to undo it “No stories found. Try a different title, format, or status.” Clear filters
Nothing yet, by design That it is quiet on purpose “Nothing has been resolved here.” (Comments, Resolved filter)
Cannot be seen That it is not empty, it is not shared “{Owner} hasn’t shared {module} with you.” See Sharing and roles

Never show the “nothing made” message when the real state is loading, offline, not downloaded or no access. Those have their own patterns and words: Loading, Saving and sync.

Anatomy

Part Rule
Heading “No {things} yet”, or the plain state. Sentence case. Title size.
Line One or two sentences: where this fills from, what it becomes. Quiet text.
Action At most one primary button. A second, quiet link only for a real alternative (import).
Frame kw-empty: dashed strong line, card radius, left-aligned, no icon required.

The dashed edge means “a place for something”. It is the only decoration an empty state gets. The founder rejected decorative illustrations in the design system; the app’s Home does draw a small story frame on an empty library, and that is the exception, not a template.

Real copy from the app

  • Home, no stories: “Every story starts somewhere.” / “Make a little room for your next idea.” Start a story
  • Home, filters on: “No stories found” / “Try a different title, format, or status.” Clear filters
  • Call sheets: “No call sheets yet” / “A call sheet is made for each shooting day, and the days are built from the screenplay’s scenes. Write or import the script, then schedule its days.”
  • Schedule: “No scenes to schedule yet” / “The schedule is built from the screenplay’s scene headings. Write or import the script, and every scene arrives here as a strip.”
  • Colour and texture: “No characters yet” / “A character gets a colour once there is a character. Write one in the character module and they arrive here…”
  • Continuity photos: “No continuity photos yet. On the day, take one of each character before the first take of every scene.”
  • Outline timeline: “No beats yet. Open Writing to begin the story.”
  • Comments: “Nothing said here yet. Start the conversation.” / “No comments here yet.”
  • Trash: “Nothing here” / “Stories you delete stay here for 30 days.”
  • Script search: “Nothing in the script matches that.”
  • Outline card: “Add words…”

The continuity line is the edge of what is allowed: it says when the artefact is made on set, which is how the sheet fills, not how to do the job well. A line that explained why continuity matters would be teaching.

Rules

  • Must name what goes here in the heading, with the noun the person uses.
  • Must say where the content comes from when it fills from another module, and give a route there.
  • Must distinguish empty from loading, offline, not downloaded, filtered and no access.
  • Must give a filtered-empty list a Clear filters action, and keep the filters visible.
  • Never use jokes, mascots, illustrations made for the empty state, or exclamation marks.
  • Never coach the craft: no questions to the writer, no “a great logline should…”.
  • Never guilt or count: no “You haven’t written in 6 days”, no streak, no progress ring.
  • Never put more than one primary action in an empty state.
  • Always keep the page’s header, tools and title in place, so the empty state reads as this screen with nothing in it, not a different screen.
  • Always let typing replace the empty state at once: an empty card that is clicked becomes the field.

Edge cases

  • Read-only person, empty module. No action button; the line says what will appear and who adds it: “Scenes appear here when Mira writes them.”
  • Guest with no account. Say where the work is kept: “No account needed. Your story is kept on this device until you sign in.”
  • Empty because a feature is switched off. Show the switch, not an empty panel (the beat map off shows only Map the outline onto the script).
  • Partially empty. A call sheet with scenes but no hospital is not empty; it is incomplete. Use an inline notice on the missing part (“Location to be confirmed. Add it before issuing the call sheet.”).
  • Very first visit. Home’s empty library is the first frame, not a generic empty state.

Phone and desktop

On a phone the empty state starts by about y = 200 under the one-line header, fills the column width with 16px gutters, and its button is full height (44px). On desktop it sits where the content would, left-aligned, at the content’s measure, never centred in a huge void. The floating button’s slot at the foot is kept clear on phones.

Accessibility

  • The heading is a real heading at the right level for the page, so screen-reader users hear the section is empty.
  • When a filter empties a list, announce the result in a polite live region: “No stories found.”
  • The action is a native button or link with its full name (“Add location”, not “Add”).
  • Dashed borders are decoration; the meaning is in the words.

“No scenes to schedule yet. The schedule is built from the screenplay’s scene headings.” Open the screenplay

Do

A clapperboard drawing and “Lights, camera… nothing yet” with Get started.

Don’t

An empty outline card that says “Add words…”.

Do

An empty outline card that asks “What does your hero want more than anything?”

Don’t

“No stories found. Try a different title, format, or status.” Clear filters, with the filter row still showing what is on.

Do

The welcome empty state for new users, shown because the search returned nothing.

Don’t

Demo

No locations yet

Locations you add here appear on every call sheet that uses them.

No stories found

Try a different title, format, or status.

No scenes to schedule yet

The schedule is built from the screenplay's scene headings. Write or import the script, and every scene arrives here as a strip.

Open the screenplay
<div class="kw-empty" style="width:100%;max-width:440px"><h3>No locations yet</h3><p>Locations you add here appear on every call sheet that uses them.</p><button class="kw-button kw-button--primary" type="button">Add location</button></div>
<div class="kw-empty" style="width:100%;max-width:440px"><h3>No stories found</h3><p>Try a different title, format, or status.</p><button class="kw-button" type="button">Clear filters</button></div>
<div class="kw-empty" style="width:100%;max-width:440px"><h3>No scenes to schedule yet</h3><p>The schedule is built from the screenplay's scene headings. Write or import the script, and every scene arrives here as a strip.</p><a class="kw-link" href="#">Open the screenplay</a></div>

Empty state, Loading, First run, Search and filter, Structure, not teaching.

AI readiness test

Task. Write the empty state for the Budget when the schedule has no days.

Give the agent. This page, Decision 0004, Decision 0022 (budget follows cast and locations).

Constraint. One action; no coaching.

A reliable answer

  • Heading names the thing (“No budget lines yet” or similar)
  • The line says the budget fills from cast, locations and scheduled days
  • The action routes to the schedule or the cast list
  • Distinct copy for read-only people with no button
  • No illustration, joke or exclamation mark

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

Open .mdllms.txt
Loading…