---
name: kwark-ux-copy
description: "Write or edit interface words in Kwark's voice: buttons, menu items, errors, save and sync states, empty states, confirmations, toasts, tooltips and settings. Use when naming a control, wording an error or empty state, or reviewing UX copy for Kwark or an app built on the Kwark system."
---

# Write interface words in Kwark's voice

Kwark's people are writers and filmmakers, often nervous, often on a phone with poor signal. The voice is calm, plain and specific. It tells them their work is safe before anything else.

## Load first

- https://kwark.space/designSystem/foundations/ux-writing.md
- https://kwark.space/designSystem/foundations/content.md
- https://kwark.space/designSystem/patterns/errors.md and https://kwark.space/designSystem/patterns/saving-and-sync.md for anything about saving
- https://kwark.space/designSystem/patterns/empty-states.md for empty screens

## Rules

- **Always** write sentence case. All caps only for screenplay elements that are capitalised by convention (scene headings, character names).
- **Must** name buttons verb + object: "Save scene", "Issue call sheet", "Share with crew". Never "Submit", "OK" or "Click here".
- **Must** keep one word through a flow: Issue → Issued, Publish → Published. If the button says Delete, the toast says Deleted.
- **Must** say the state of the work first: "Saved", "Saved on this device", "Safe here, waiting to reach the cloud". Never "failed", never raw error text (Decision 0013).
- **Must** write errors as what happened + that the work is safe (when true) + what to do: "This scene didn't reach the cloud. It's saved on this device and will try again."
- **Must** write empty states as what goes here + why + one action: "No scenes yet. Scenes appear here as you write headings. Write the first scene."
- **Never** apologise, blame, joke, shout or use exclamation marks.
- **Never** judge or grade the writing: no "great", "weak", "score", "rating", percentages of quality. Describe, do not evaluate: "Scene 12 runs about 2 minutes", never "Scene 12 is too long".
- **Never** use hype words: seamless, robust, powerful, effortless, magic, unlock, elevate, delightful.
- **Prefer** Undo over "Are you sure?". Confirm only what cannot be undone or what changes other people's work, and name the object: "Delete Act 2 and its 14 scenes?"
- **Always** use the film industry's own words for its artefacts (call sheet, stripboard, breakdown, sides), and plain words for everything else.

## How to answer

Give the copy, then one line per choice explaining which rule it follows. Give the phone version if it must be shorter (a phone header title is one word). Flag any string that implies a feature or a promise the product does not keep.
