# Production calendar

> The calendar for artists: a week time grid with the day job dimmed, a month, and What is next, in seven film categories.

Source: https://kwark.space/designSystem/components/production-calendar

## Usage

### When to use
For a film's dates and the people working on it: evening writing blocks, table reads, rehearsals, recces, shoot days, meetings, deadlines (Decision 0043). It is Microsoft Teams speed in warm film tokens, so a 9–5 worker's evening hours do not feel clinical.

### The seven categories
| Category | Token | Use |
|---|---|---|
| Writing session | `--k-cal-writing` | Script blocks, often recurring |
| Rehearsal | `--k-cal-rehearsal` | |
| Reading | `--k-cal-reading` | Table reads |
| Shoot day | `--k-cal-shoot` | From the schedule; shows *Day 4* |
| Recce | `--k-cal-recce` | Location scouts |
| Meeting | `--k-cal-meeting` | |
| Deadline | `--k-cal-deadline` | Submissions, delivery |
Away and phases are a quiet overlay toggle, not categories.

### Views
- **Week** (default on desktop), Work week, Day: 24-hour grid, optional *Dim 9–5 day job* hatch, accent now-line, drag to create in 15-minute steps, drag to move, drag the bottom to resize.
- **Month**: shoot day numbers, one line per item, *+1 more*.
- **Next**: what is coming, grouped, with clashes and moves in words.
- **Agenda**: default on phones (≤640px).
- **Timeline**: the project's phases from first draft to release ([Production timeline](https://kwark.space/designSystem/components/production-timeline.md)).

### When not to
- No streaks, no scores, no productivity counts. Zero guilt on rest days (0001, 0037).
- Never alarm colours for ordinary items; red only for a clash someone must resolve.

### Writing
Quick add understands phrases locally: *Table read with Meera next Tue 7pm–9pm Sc 4, 7*. Clashes name the person: *Arjun is also on the rooftop recce*.

**Do:** Evening pages 19:30–21:00 standing out calmly above a hatched day job.

**Don't:** A grey corporate grid with a "3-day streak" flame.

## Style

### Anatomy

Event: 7px corners, 4px category bar on the left, category wash and ink, title 600 two lines, badges for scenes and clashes. Month cell min-height 104px (84 in the system), today number in a 22px accent disc. Next line grid `92px 1fr auto`.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-cal-writing` | #98633f | #e8b58b |
| `--k-cal-reading` | #a87b32 | #dcb36a |
| `--k-cal-recce` | #4d6a7a | #83aac0 |
| `--k-cal-shoot` | #826d35 | #c4b068 |
| `--k-cal-dayjob-bg` | #f4f1ea | #1d1c1a |
| `--k-cal-dayjob-stripe` | #eae4da | #24221f |
| `--k-accent` | #98633f | #98633f |
| `--k-warn` | #8a5a00 | #d8a44a |
| `--k-danger` | #b4382c | #e0685c |

## Code

### React

In the Kwark app: `import { TimeGridView } from '@/pages/PreProduction/ProjectCalendarModule/components/TimeGridView'`.

```tsx
// Also MonthView.tsx, NextView.tsx, AgendaView.tsx, TimelineView.tsx (TimelinePage.tsx hosts them)
<TimeGridView days={weekDaysFrom(monday, 7)} entries={entries} dimDayJob={dim} onSelect={open} />
```

| Prop | Type | Notes |
|---|---|---|
| `days` | `string[]` | weekDaysFrom(monday, 1 | 5 | 7) |
| `dimDayJob` | `boolean` | hatches 09:00–17:00 |
| `entries` | `CalendarEntry[]` | with category, recurrence, scenes, attendees |

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<div class="kw-tgrid" aria-label="Week of 18 November, evenings">
  <span></span><span class="kw-tgrid__head"><b>18</b>Mon</span><span class="kw-tgrid__head" aria-current="date"><b>19</b>Tue</span><span class="kw-tgrid__head"><b>20</b>Wed</span>
  <div class="kw-tgrid__hours" aria-hidden="true"><span>16:00</span><span>17:00</span><span>18:00</span><span>19:00</span><span>20:00</span></div>
  <div class="kw-tgrid__col"><i data-dayjob></i><i data-dayjob></i><i></i><i></i><i></i><button class="kw-ev kw-cat-writing" type="button" style="top:140px;height:58px"><strong>Evening pages</strong><span class="kw-ev__meta">19:30–21:00 · repeats weekdays</span></button></div>
  <div class="kw-tgrid__col"><i data-dayjob></i><i data-dayjob></i><i></i><i></i><i></i><button class="kw-ev kw-cat-reading" type="button" style="top:120px;height:78px" aria-selected="true"><strong>Table read with Meera</strong><span class="kw-ev__meta"><span class="kw-ev__badge">Sc 4, 7</span><span class="kw-ev__badge" data-clash>Clash: Arjun</span></span></button><span class="kw-now" style="top:96px" aria-hidden="true"></span></div>
  <div class="kw-tgrid__col"><i data-dayjob></i><i data-dayjob></i><i></i><i></i><i></i><button class="kw-ev kw-cat-recce" type="button" style="top:84px;height:46px"><strong>Recce: rooftop</strong></button></div>
</div>
<div class="kw-month" aria-label="November 2026">
  <span></span><span class="kw-month__dow">Mon</span><span class="kw-month__dow">Tue</span><span class="kw-month__dow">Wed</span><span class="kw-month__dow">Thu</span><span class="kw-month__dow">Fri</span><span class="kw-month__dow">Sat</span><span class="kw-month__dow">Sun</span>
  <span class="kw-month__week"><b>Week 4</b>Prep</span>
  <button class="kw-month__cell" type="button"><span class="kw-month__top"><span class="kw-month__num">16</span></span></button>
  <button class="kw-month__cell" type="button"><span class="kw-month__top"><span class="kw-month__num">17</span></span></button>
  <button class="kw-month__cell kw-cat-reading" type="button" aria-current="date"><span class="kw-month__top"><span class="kw-month__num">18</span></span><span class="kw-month__item"><i></i><span>Table read</span></span></button>
  <button class="kw-month__cell kw-cat-recce" type="button"><span class="kw-month__top"><span class="kw-month__num">19</span></span><span class="kw-month__item"><i></i><span>Recce: rooftop</span></span></button>
  <button class="kw-month__cell kw-cat-shoot" type="button"><span class="kw-month__top"><span class="kw-month__num">20</span><span class="kw-month__day">Day 3</span></span><span class="kw-month__item"><i></i><span>Sc 12, 3</span></span></button>
  <button class="kw-month__cell kw-cat-shoot" type="button" aria-selected="true"><span class="kw-month__top"><span class="kw-month__num">21</span><span class="kw-month__day">Day 4</span></span><span class="kw-month__item"><i></i><span>Sc 12, 3, 14</span></span><span class="kw-month__more">+1 more</span></button>
  <button class="kw-month__cell" type="button" data-out><span class="kw-month__top"><span class="kw-month__num">22</span></span></button>
</div>
<div class="kw-next">
  <section><h3>This week</h3>
    <button class="kw-next__line kw-cat-reading" type="button"><span class="kw-next__date"><b>Tue 19</b>19:00</span><span>Table read with Meera<small data-clash>Arjun is also on the rooftop recce</small></span><span class="kw-next__source"><i></i>Reading</span></button>
    <button class="kw-next__line kw-cat-shoot" type="button"><span class="kw-next__date"><b>Thu 21</b>07:30</span><span>Day 4 · Lumen Studios<small>Scenes 12, 3, 14</small></span><span class="kw-next__source"><i></i>Shoot day</span></button>
  </section>
</div>
```

## Accessibility

### Keyboard (single keys, suppressed while typing)
| Key | Does |
|---|---|
| C | Quick add |
| T | Today |
| W / X / D | Week / Work week / Day |
| M / A / L | Month / Agenda / Timeline |
| B | Toggle the day-job dim |
| [ / ] | Previous / next |
| ? | Shortcuts |
| Esc | Close the inspector |

- Events are buttons named with category, title, time and clash.
- Drag actions all have inspector equivalents.

## For agents

### Rules

- **Must** use the seven calendar categories and their tokens; never invent event colours.
- **Never** show streaks, scores or productivity counts.
- **Must** default to Agenda on phones and Week on desktop.
- **Always** name the person in a clash warning.

### AI readiness test

**Task:** Add a recurring evening writing block for a writer with a day job.

**Give the agent:** Production calendar, Decision 0043.

**Constraint:** Recurrence must be one document, not one per day.

**A reliable answer:**
- Writing category
- One recurrence rule
- "Just this day" and "This and future" on edit
- Day-job dim available
- No streak
