# Gantt chart

> The shooting schedule as bars across shoot days: one row per location, day and night work told apart, company moves marked where the unit packs up mid-day, days off hatched.

Source: https://kwark.space/designSystem/components/gantt-chart

## Usage

### What it is
A Gantt chart draws work that lasts across days as bars against a calendar. In Kwark it is the **shooting schedule seen from above**: the stripboard tells a 1st AD the order of scenes inside a day, the Gantt tells the producer and the location manager *where the unit is on which day, and when it moves*.

The specimen is two weeks of Blank Pages: 12 shoot days, five locations, two Sundays off, and two **company moves**, the moments the whole unit packs up and drives to the next location during a shoot day. A move costs the day 35 to 50 minutes of shooting, so it is the thing a schedule is most often re-cut to avoid. A generic Gantt has no place for it. This one gives it a row.

### When to use
- The schedule overview: shoot days per location, split days, night work, days off.
- Prep and post plans where overlap matters: recce, rehearsal, build, wrap-out.
- Any plan where a bar is a stretch of days and a gap means something (a day off, a turnaround).

### When not to
- For the order of scenes within a day. Use the [Stripboard strip](https://kwark.space/designSystem/components/stripboard-strip.md).
- For a film's phases from first draft to release. Use the [Production timeline](https://kwark.space/designSystem/components/production-timeline.md).
- For hours inside one day (crew call to wrap). Use the [Production calendar](https://kwark.space/designSystem/components/production-calendar.md) week view.
- For task tracking with owners and dependencies. Kwark is not a task tracker; dependencies go in words in the table.

### Anatomy in use
- **Header**: one column per calendar day, *Day 4* above *Thu 21*. Shoot days are numbered the way the call sheet numbers them; days off say *Off* and do not take a number.
- **Rows**: one per location, named the way the location list names it (*Lumen Studios, Stage 2*), with the set from the script under it (*INT. EDIT SUITE*).
- **Bars**: a block of work at that location, labelled with its scenes. Each day is two halves, so a split day reads exactly.
- **Light**: day work is mango, night work is aqua. The words *night* and *dawn* are in the bar's name and in the table, never colour alone.
- **Company moves**: a dashed coral rule through every row at the moment of the move, with a van and the drive time at the foot.
- **Today**: a 2px rule in the text colour, labelled in the header. Not red: being on Day 4 is not an alarm.

### Writing
- The reading line says the schedule in one sentence: *12 shoot days over two weeks, 5 locations, 2 company moves. Today is Day 4.*
- Bars name scenes (*Sc 12, 14, 15*); the table carries the full location, scene list and light.
- A move is a fact with its time: *35 min*. Never *Inefficient* or a warning colour.

**Do:** Five location rows, scenes on the bars, two company moves with their drive times, days off hatched and unnumbered.

**Don't:** One bar per scene in a rainbow of colours, the today line in red, and Sundays numbered as shoot days.

**Do:** *Rooftop · Sc 13 · night* in aqua with the word *night* in its name.

**Don't:** Night work told apart only by a darker colour.

## Style

### Anatomy

1. **Frame**: the chart card (`.kw-viz`), 1px `--k-line`, 10px corners, 16px × 24px padding.
2. **Head**: title 14px 600, the reading in 12px `--k-text-2`, the **Table** switch on the right.
3. **Grid** (`.kw-sched__grid`): a 168px sticky location column, then two columns per calendar day, each at least 20px. The body scrolls sideways inside the card; the location column stays.
4. **Day header**: 56px (the top 20px holds the *Today* tag), *Day n* 12px 600 over the date in 12px `--k-text-2`. Today's header takes `--k-raise`.
5. **Row**: 40px, 1px `--k-line` between days.
6. **Bar**: 28px tall, 6px corners, 3px left edge in the light colour, fill at 22% of it on the surface, label 12px 500 `--k-text`, truncated with an ellipsis.
7. **Company move**: 0 width, 2px dashed coral down every row, a 22px pill at the foot with a 14px van and the minutes.
8. **Day off**: a 135° hatch at 6% of the text colour.
9. **Today**: 2px `--k-text` rule from header to foot.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-chart-mango` | #b4802e | var(--k-brand-mango) |
| `--k-chart-aqua` | #509ca0 | var(--k-brand-aqua) |
| `--k-chart-coral` | #bf5d45 | var(--k-brand-coral) |
| `--k-surface` | #ffffff | #1a1a1a |
| `--k-raise` | #f1f5f9 | #252525 |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-radius-card` | 10px |  |
| `--k-radius-control` | 6px |  |
| `--k-fs-meta` | 12px |  |

### Colour
| Mark | Token | Why |
|---|---|---|
| Day work | `--k-chart-mango` | Palette No. 300 mango, 25% lower in lightness for light rooms |
| Night work | `--k-chart-aqua` | Aqua, the cool partner of mango |
| Company move | `--k-chart-coral` | Coral, used only for the move so it is never mistaken for work |
| Today | `--k-text` | A position, not a state |

### States
| State | Look |
|---|---|
| Rest | Fill 22%, 3px edge |
| Hover | Fill 34% |
| Focus | 2px `--k-focus` outline drawn inside the bar, so it is never clipped by the row |
| Selected (`aria-pressed="true"`) | Fill 34% and a 1px border all round in the light colour |
| Split day | A bar that starts or ends on a half column |

## Code

### React

Use the HTML below with `kwark.css`. The example shows the markup and styling. Supply any application behavior described on this page.

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<figure class="kw-viz kw-viz--wide">
  <figcaption class="kw-viz__head"><div><p class="kw-viz__title">Shooting schedule · Blank Pages</p><p class="kw-viz__reading">12 shoot days over two weeks, 5 locations, 2 company moves. Today is Day 4.</p></div><label class="kw-viz__switch"><input class="kw-visually-hidden" type="checkbox" role="switch" aria-label="Show the shooting schedule as a table"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="4" width="18" height="16" rx="2"/><path d="M3 10h18M3 15h18M9 10v10"/></svg><span>Table</span></label></figcaption>
  <div class="kw-viz__plot">
    <div class="kw-sched" tabindex="0" role="group" aria-label="Shooting schedule, scrolls sideways">
      <div class="kw-sched__grid" style="--kw-halves:28"><div class="kw-sched__corner" style="grid-row:1;grid-column:1">Location</div><div class="kw-sched__day" style="grid-row:1;grid-column:2 / span 2"><b>Day 1</b><span>Mon 18</span></div><div class="kw-sched__col" style="grid-row:2 / span 6;grid-column:2 / span 2" aria-hidden="true"></div><div class="kw-sched__day" style="grid-row:1;grid-column:4 / span 2"><b>Day 2</b><span>Tue 19</span></div><div class="kw-sched__col" style="grid-row:2 / span 6;grid-column:4 / span 2" aria-hidden="true"></div><div class="kw-sched__day" style="grid-row:1;grid-column:6 / span 2"><b>Day 3</b><span>Wed 20</span></div><div class="kw-sched__col" style="grid-row:2 / span 6;grid-column:6 / span 2" aria-hidden="true"></div><div class="kw-sched__day is-today" style="grid-row:1;grid-column:8 / span 2"><b>Day 4</b><span>Thu 21</span></div><div class="kw-sched__col" style="grid-row:2 / span 6;grid-column:8 / span 2" aria-hidden="true"></div><div class="kw-sched__day" style="grid-row:1;grid-column:10 / span 2"><b>Day 5</b><span>Fri 22</span></div><div class="kw-sched__col" style="grid-row:2 / span 6;grid-column:10 / span 2" aria-hidden="true"></div><div class="kw-sched__day" style="grid-row:1;grid-column:12 / span 2"><b>Day 6</b><span>Sat 23</span></div><div class="kw-sched__col" style="grid-row:2 / span 6;grid-column:12 / span 2" aria-hidden="true"></div><div class="kw-sched__day is-off" style="grid-row:1;grid-column:14 / span 2"><b>Off</b><span>Sun 24</span></div><div class="kw-sched__col is-off" style="grid-row:2 / span 6;grid-column:14 / span 2" aria-hidden="true"></div><div class="kw-sched__day" style="grid-row:1;grid-column:16 / span 2"><b>Day 7</b><span>Mon 25</span></div><div class="kw-sched__col" style="grid-row:2 / span 6;grid-column:16 / span 2" aria-hidden="true"></div><div class="kw-sched__day" style="grid-row:1;grid-column:18 / span 2"><b>Day 8</b><span>Tue 26</span></div><div class="kw-sched__col" style="grid-row:2 / span 6;grid-column:18 / span 2" aria-hidden="true"></div><div class="kw-sched__day" style="grid-row:1;grid-column:20 / span 2"><b>Day 9</b><span>Wed 27</span></div><div class="kw-sched__col" style="grid-row:2 / span 6;grid-column:20 / span 2" aria-hidden="true"></div><div class="kw-sched__day" style="grid-row:1;grid-column:22 / span 2"><b>Day 10</b><span>Thu 28</span></div><div class="kw-sched__col" style="grid-row:2 / span 6;grid-column:22 / span 2" aria-hidden="true"></div><div class="kw-sched__day" style="grid-row:1;grid-column:24 / span 2"><b>Day 11</b><span>Fri 29</span></div><div class="kw-sched__col" style="grid-row:2 / span 6;grid-column:24 / span 2" aria-hidden="true"></div><div class="kw-sched__day" style="grid-row:1;grid-column:26 / span 2"><b>Day 12</b><span>Sat 30</span></div><div class="kw-sched__col" style="grid-row:2 / span 6;grid-column:26 / span 2" aria-hidden="true"></div><div class="kw-sched__day is-off" style="grid-row:1;grid-column:28 / span 2"><b>Off</b><span>Sun 1</span></div><div class="kw-sched__col is-off" style="grid-row:2 / span 6;grid-column:28 / span 2" aria-hidden="true"></div><div class="kw-sched__place" style="grid-row:2;grid-column:1"><strong>Lumen Studios, Stage 2</strong><small>INT. EDIT SUITE</small></div><button type="button" class="kw-sched__bar" style="grid-row:2;grid-column:2 / span 7" data-light="day" aria-label="Lumen Studios, Stage 2, Day 1 to Day 4 morning, scenes 12, 14, 15, day work"><span>Sc 12, 14, 15</span></button><button type="button" class="kw-sched__bar" style="grid-row:2;grid-column:23 / span 3" data-light="day" aria-label="Lumen Studios, Stage 2, Day 10 afternoon to Day 11, scenes 31, 40, day work"><span>Sc 31, 40</span></button><div class="kw-sched__place" style="grid-row:3;grid-column:1"><strong>Andheri East, Lane 4</strong><small>EXT. STREET</small></div><button type="button" class="kw-sched__bar" style="grid-row:3;grid-column:9 / span 3" data-light="day" aria-label="Andheri East, Lane 4, Day 4 afternoon to Day 5, scenes 3, 9, day work"><span>Sc 3, 9</span></button><div class="kw-sched__place" style="grid-row:4;grid-column:1"><strong>Old Film Lab rooftop</strong><small>EXT. ROOF</small></div><button type="button" class="kw-sched__bar" style="grid-row:4;grid-column:12 / span 2" data-light="night" aria-label="Old Film Lab rooftop, Day 6, scenes 13, night work"><span>Sc 13</span></button><button type="button" class="kw-sched__bar" style="grid-row:4;grid-column:16 / span 2" data-light="night" aria-label="Old Film Lab rooftop, Day 7, scenes 22, night work"><span>Sc 22</span></button><div class="kw-sched__place" style="grid-row:5;grid-column:1"><strong>Mira's flat, Versova</strong><small>INT. FLAT</small></div><button type="button" class="kw-sched__bar" style="grid-row:5;grid-column:18 / span 5" data-light="day" aria-label="Mira's flat, Versova, Day 8 to Day 10 morning, scenes 2, 5, 18, day work"><span>Sc 2, 5, 18</span></button><div class="kw-sched__place" style="grid-row:6;grid-column:1"><strong>Highway, Goregaon</strong><small>EXT. HIGHWAY – DAWN</small></div><button type="button" class="kw-sched__bar" style="grid-row:6;grid-column:26 / span 2" data-light="day" aria-label="Highway, Goregaon, Day 12, dawn, scenes 1, day work"><span>Sc 1</span></button><div class="kw-sched__place kw-sched__place--moves" style="grid-row:7;grid-column:1"><strong>Company moves</strong><small>during a shoot day</small></div><div class="kw-sched__move" style="grid-row:2 / span 6;grid-column:9 / span 1" role="note" aria-label="Company move on Day 4, Lumen Studios to Andheri East, about 35 min"><span><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3 7h11v9H3zM14 10h4l3 3v3h-7"/><circle cx="7" cy="17.5" r="1.5"/><circle cx="17" cy="17.5" r="1.5"/></svg>35 min</span></div><div class="kw-sched__move" style="grid-row:2 / span 6;grid-column:23 / span 1" role="note" aria-label="Company move on Day 10, Mira's flat to Lumen Studios, about 50 min"><span><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3 7h11v9H3zM14 10h4l3 3v3h-7"/><circle cx="7" cy="17.5" r="1.5"/><circle cx="17" cy="17.5" r="1.5"/></svg>50 min</span></div><div class="kw-sched__today" style="grid-row:1 / span 7;grid-column:8 / span 1" aria-hidden="true"></div></div>
    </div>
    <p class="kw-viz__foot" aria-hidden="true"><span class="kw-viz__key" style="--kw-key:var(--k-chart-mango)">Day work</span><span class="kw-viz__key" style="--kw-key:var(--k-chart-aqua)">Night work</span><span class="kw-viz__key kw-viz__key--dash" style="--kw-key:var(--k-chart-coral)">Company move</span><span class="kw-viz__key kw-viz__key--hatch">Day off</span></p>
  </div>
  <div class="kw-viz__table"><table><caption>Shooting schedule, Blank Pages, 18 November to 1 December</caption><thead><tr><th scope="col">Day</th><th scope="col">Date</th><th scope="col">Location</th><th scope="col">Scenes</th><th scope="col">Light</th><th scope="col">Company move</th></tr></thead><tbody><tr><th scope="row">Day 1</th><td>Mon 18</td><td>Lumen Studios, Stage 2</td><td>Sc 12, 14, 15</td><td>Day</td><td></td></tr><tr><th scope="row">Day 2</th><td>Tue 19</td><td>Lumen Studios, Stage 2</td><td>Sc 12, 14, 15</td><td>Day</td><td></td></tr><tr><th scope="row">Day 3</th><td>Wed 20</td><td>Lumen Studios, Stage 2</td><td>Sc 12, 14, 15</td><td>Day</td><td></td></tr><tr><th scope="row">Day 4</th><td>Thu 21</td><td>Lumen Studios, Stage 2, morning; then Andheri East, Lane 4, afternoon</td><td>Sc 12, 14, 15; Sc 3, 9</td><td>Day</td><td>Lumen Studios to Andheri East, about 35 min</td></tr><tr><th scope="row">Day 5</th><td>Fri 22</td><td>Andheri East, Lane 4</td><td>Sc 3, 9</td><td>Day</td><td></td></tr><tr><th scope="row">Day 6</th><td>Sat 23</td><td>Old Film Lab rooftop</td><td>Sc 13</td><td>Night</td><td></td></tr><tr><th scope="row">Off</th><td>Sun 24</td><td>Day off</td><td></td><td></td><td></td></tr><tr><th scope="row">Day 7</th><td>Mon 25</td><td>Old Film Lab rooftop</td><td>Sc 22</td><td>Night</td><td></td></tr><tr><th scope="row">Day 8</th><td>Tue 26</td><td>Mira's flat, Versova</td><td>Sc 2, 5, 18</td><td>Day</td><td></td></tr><tr><th scope="row">Day 9</th><td>Wed 27</td><td>Mira's flat, Versova</td><td>Sc 2, 5, 18</td><td>Day</td><td></td></tr><tr><th scope="row">Day 10</th><td>Thu 28</td><td>Lumen Studios, Stage 2, afternoon; then Mira's flat, Versova, morning</td><td>Sc 31, 40; Sc 2, 5, 18</td><td>Day</td><td>Mira's flat to Lumen Studios, about 50 min</td></tr><tr><th scope="row">Day 11</th><td>Fri 29</td><td>Lumen Studios, Stage 2</td><td>Sc 31, 40</td><td>Day</td><td></td></tr><tr><th scope="row">Day 12</th><td>Sat 30</td><td>Highway, Goregaon</td><td>Sc 1</td><td>Day</td><td></td></tr><tr><th scope="row">Off</th><td>Sun 1</td><td>Day off</td><td></td><td></td><td></td></tr></tbody></table></div>
</figure>
```

### Building it
- Lay the chart out as one CSS grid. Set `--kw-halves` to twice the number of calendar days; place each bar with `grid-row` (its location) and `grid-column: <2 + start half> / span <halves>`.
- Company moves and day-off columns span every body row (`grid-row: 2 / span <rows>`); the today rule spans the header too.
- Keep the table in the same figure. The **Table** switch shows it in place of the chart with CSS only (`:has(input:checked)`); without the switch it stays visually hidden and readable by screen readers.
- Generate the table from the same data as the bars. Never type it twice.

## Accessibility

### Keyboard
| Key | Does |
|---|---|
| Tab | Moves to the scroll area, then through the bars in reading order (location by location) |
| Left and right arrows | Scroll the schedule sideways when the scroll area has focus |
| Enter or Space on a bar | Opens that block's days in the stripboard |
| Space on **Table** | Shows the schedule as a table |

### Screen readers
- Each bar is a button named in full: *Lumen Studios, Stage 2, Day 1 to Day 4 morning, scenes 12, 14, 15, day work*.
- Company moves are notes named with the day, route and minutes.
- The table always holds every day, location, scene list, light and move.

### Colour and touch
- Day and night differ by words as well as colour. Moves are dashed, not only coral.
- On a phone the location column stays and the days scroll; bars are 28px high inside 40px rows, so the whole row is the touch target when opened from the list.

## For agents

### Rules

- **Must** number shoot days the way the call sheet does and leave days off unnumbered.
- **Must** give every company move its own mark with the drive time.
- **Never** tell day from night by colour alone; put the word in the bar and the table.
- **Never** draw today, a split day or a move in a warning colour.
- **Always** keep the table in the figure, built from the same data as the bars.
- **Must** keep the location column visible while the days scroll.

### AI readiness test

**Task:** Show the location manager where the unit is for the three weeks of the Blank Pages shoot.

**Give the agent:** This page, Stripboard strip, Call sheet, Data visualisation.

**Constraint:** Week 2 has a split day at the rooftop and a Saturday night exterior; Sundays are off.

**A reliable answer:**
- One row per location with its set
- Shoot days numbered as on the call sheet, Sundays Off and unnumbered
- The split day drawn in half columns with a company move mark and minutes
- Night work in aqua with the word night
- Table switch with every day
