# Call sheet

> The day's sheet on paper: production, call time, scenes, cast, locations and safety, issued as numbered, frozen revisions.

Source: https://kwark.space/designSystem/components/call-sheet

## Usage

### When to use
For each shoot day, by the 2nd AD, the night before. It is a paper artefact and a structured one in one act (Decision 0005): the same frozen revision prints, saves as PDF and downloads as CSV.

### Issue, revise, never overwrite (Decision 0020)
- **Issue Rev N** freezes the current sheet as revision N of that day. The working sheet stays editable.
- The switch *Working draft / Rev N* chooses which copy you are looking at. The status line says *Matches Rev 3* or *Edited since Rev 3*.
- *Save as PDF* and *Download CSV* act on the issued revision you are viewing; on a draft they are disabled with the reason written on the page.
- The day tab carries *Rev 3*. A printed working draft carries a *Draft, not issued* stamp.
- Issuing does not send anything. The toast says what issuing means.

### Conventions on the sheet
Crew call large and boxed; day *4 of 18*; breakfast, shooting call, lunch; sunrise and sunset; weather; scenes with set, D/N, pages in eighths and cast IDs; cast with pick-up, make-up and on-set times; locations with unit base and parking; the nearest hospital. Times are 24-hour where the production works in 24-hour time.

### When not to
- As the schedule. The schedule is the [Stripboard](https://kwark.space/designSystem/components/stripboard-strip.md); the call sheet reads from it.
- To send personal phone numbers to the whole crew. Contacts are scoped by role (Decision 0042).

### Writing
The company name on the sheet is the call sheet's company field when someone typed one (a co-production), else the house name (Decision 0022). Labels are sentence case on screen and in print.

**Do:** *Issue Rev 4*, then the crew holds a paper that says *Rev 4* and matches the screen.

**Don't:** One editable sheet whose "Issued" word nothing sets, overwritten all night.

## Style

### Anatomy

Paper up to 900px, 18–40px padding, 4px corners. Top: company, title 28px Raleway, people in three columns; call box with a 2px ink border and 44px mono time. Times grid of six. Blocks separated by 1px paper lines; tables with a 2px ink head rule.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-paper` | #fbfbf8 |  |
| `--k-paper-ink` | #1e2326 |  |
| `--k-paper-muted` | #4a5054 |  |
| `--k-paper-line` | #d5d9d4 |  |
| `--k-ok` | #2c6e49 | #6cc08a |
| `--k-danger` | #b4382c | #e0685c |
| `--k-font-mono` | ui-monospace, 'SF Mono', Menlo, Consolas, monospace |  |

## Code

### React

In the Kwark app: `import { CallSheets } from '@/pages/PreProduction/CallSheetsModule/CallSheets'`.

```tsx
<CallSheets production={useProduction()} />
// Issue: CallSheetIssue + callSheetIssue.ts (frozen revision builder)
```

| Prop | Type | Notes |
|---|---|---|
| `production` | `ReturnType<typeof useProduction>` | schedule, cast, locations, revisions |

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<div class="kw-cs-days" role="tablist" aria-label="Shoot days"><button type="button" role="tab" aria-selected="false"><strong>Day 3</strong><span>Wed 20 Nov</span><i>Rev 2</i></button><button type="button" role="tab" aria-selected="true"><strong>Day 4</strong><span>Thu 21 Nov</span><i>Rev 3</i></button><button type="button" role="tab" aria-selected="false"><strong>Day 5</strong><span>Fri 22 Nov</span></button></div>
<div class="kw-cs-issue"><div class="kw-segment" role="group" aria-label="Which copy"><button type="button" aria-pressed="false">Working draft</button><button type="button" aria-pressed="true">Rev 3</button></div><span>Edited since Rev 3</span><button class="kw-button kw-button--primary kw-button--sm" type="button">Issue Rev 4</button><button class="kw-button kw-button--sm" type="button">Save as PDF</button><button class="kw-button kw-button--sm" type="button">Download CSV</button></div>
<article class="kw-paper" aria-label="Call sheet, Day 4, revision 3">
  <div class="kw-cs-top">
    <div><span class="kw-cs-company">Thea Experience</span><h2>Blank Pages</h2>
      <div class="kw-cs-people"><span class="kw-cs-slot"><span>Director</span><b>Mira Rao</b></span><span class="kw-cs-slot"><span>Producer</span><b>Dev M.</b></span><span class="kw-cs-slot"><span>1st AD</span><b>Sana K.</b></span></div></div>
    <div class="kw-cs-call"><span>Crew call</span><strong>07:30</strong><em>Day 4 of 18</em><span>Thu 21 Nov 2026</span><span class="kw-cs-stamp">Rev 3</span></div>
  </div>
  <div class="kw-cs-times"><span class="kw-cs-slot"><span>Breakfast</span><b>06:45</b></span><span class="kw-cs-slot"><span>Shooting call</span><b>08:30</b></span><span class="kw-cs-slot"><span>Lunch</span><b>13:00</b></span><span class="kw-cs-slot"><span>Sunrise</span><b>06:31</b></span><span class="kw-cs-slot"><span>Sunset</span><b>17:44</b></span><span class="kw-cs-slot"><span>Weather</span><b>Rain, 24°</b></span></div>
  <section class="kw-cs-block"><h3>Scenes</h3><table class="kw-cs-table"><thead><tr><th>Sc</th><th>Set and description</th><th>D/N</th><th>Pages</th><th>Cast</th></tr></thead><tbody><tr><td class="num">12</td><td><strong>Int. Edit suite</strong><small>Mira finds the frame</small></td><td>N</td><td class="num">1 3/8</td><td class="num">1</td></tr><tr><td class="num">3</td><td><strong>Int. Lab corridor</strong><small>The courier arrives</small></td><td>D</td><td class="num">5/8</td><td class="num">1, 2</td></tr></tbody></table></section>
  <section class="kw-cs-block"><h3>Cast</h3><table class="kw-cs-table"><thead><tr><th>#</th><th>Character</th><th>Artist</th><th>Pick-up</th><th>Make-up</th><th>On set</th></tr></thead><tbody><tr><td class="num">1</td><td><strong>Mira</strong></td><td>Ira Sen</td><td class="num">06:30</td><td class="num">07:00</td><td class="num">08:15</td></tr><tr><td class="num">2</td><td><strong>Arjun</strong></td><td>Dev Malhotra</td><td class="num">07:15</td><td class="num">07:45</td><td class="num">08:30</td></tr></tbody></table></section>
  <section class="kw-cs-block"><h3>Locations and safety</h3><div class="kw-cs-stop"><i>1</i><div><strong>Lumen Studios, Stage 2</strong><small>Unit base and parking at Gate 3</small></div></div><div class="kw-cs-stop" style="margin-top:8px"><i>H</i><div><strong>Nearest hospital: City General, 4 km</strong><small>Open all hours</small></div></div></section>
</article>
```

## Accessibility

- Days are tabs. The sheet is an `<article>` named with day and revision.
- Disabled PDF and CSV show their reason in text beside them.
- Print: inputs lose their borders, the day tabs and issue bar do not print.

## For agents

### Rules

- **Must** issue numbered, frozen revisions per day and keep the working draft editable.
- **Must** print a Draft, not issued stamp on working drafts.
- **Never** say issuing sends the sheet; it freezes it.
- **Must** keep the paper in paper colours in dark mode and in print.

### AI readiness test

**Task:** Change Day 4's crew call after Rev 3 was issued.

**Give the agent:** Call sheet, Decision 0020, Toast.

**Constraint:** Some of the crew already printed Rev 3.

**A reliable answer:**
- Working draft edited
- Status says Edited since Rev 3
- Issue Rev 4 freezes the new copy
- Rev 3 remains viewable
- Toast says what issuing means
