Kwark. Design System
Open Kwark

Transport bar

Mark in and out, step, play backwards and forwards, loop, marker and match frame, in one 32px row; with the J/K/L shuttle gauge that shows speed and direction.

ComponentsCreative toolsReady for Kwark
01:04:10:07In → out00:00:06:06
L pressed twice: forwards at 2×
01:04:10:07Playing
<div class="kw-pro kw-pro-panel kw-pro-tbar"><output class="kw-pro-tc kw-pro-tc--md">01<i>:</i>04<i>:</i>10<i>:</i>07</output><div class="kw-pro-transport" role="toolbar" aria-label="Program transport"><button class="kw-pro-btn" type="button" aria-label="Mark in (I)" title="Mark in (I)"><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="M14 4H9v16h5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Mark out (O)" title="Mark out (O)"><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="M10 4h5v16h-5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to in (Shift I)" title="Go to in (Shift I)"><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="M9 5H6v14h3M20 12h-9m3-3.5L10.5 12l3.5 3.5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Back one frame (Left arrow)" title="Back one frame (Left arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5 5h2v14H5zM19 5v14L8.5 12z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Play backwards (J)" title="Play backwards (J)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 4.5v15L5 12z"/></svg></button><button class="kw-pro-btn kw-pro-btn--play" type="button" aria-label="Play (Space or L)" title="Play (Space or L)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M7 4.5v15l12-7.5z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Forward one frame (Right arrow)" title="Forward one frame (Right arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 5h2v14h-2zM5 5v14l10.5-7z"/></svg></button><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to out (Shift O)" title="Go to out (Shift O)"><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="M15 5h3v14h-3M4 12h9m-3-3.5 3.5 3.5-3.5 3.5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn" type="button" aria-pressed="false" aria-label="Loop playback (Command L)" title="Loop playback (Command L)"><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="M17 3l3 3-3 3M4 11V9a3 3 0 0 1 3-3h13M7 21l-3-3 3-3M20 13v2a3 3 0 0 1-3 3H4"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Add marker (M)" title="Add marker (M)"><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="M6 3h12v11l-6 6-6-6z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Match frame (F)" title="Match frame (F)"><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="8" height="7" rx="1"/><rect x="13" y="13" width="8" height="7" rx="1"/><path d="M11 7.5h3a3 3 0 0 1 3 3V13"/></svg></button></div><span class="kw-pro-sp"></span><span class="kw-pro-dim">In → out</span><span class="kw-pro-tc">00<i>:</i>00<i>:</i>06<i>:</i>06</span></div>
<div class="kw-pro" style="display:flex;flex-wrap:wrap;gap:16px;align-items:center"><div class="kw-pro-shuttle" role="img" aria-label="Shuttle: playing forwards at 2 times"><span>◀ 8×</span><span>◀ 4×</span><span>◀ 2×</span><span>◀ 1×</span><span data-stop>K</span><span>1× ▶</span><span data-on>2× ▶</span><span>4× ▶</span><span>8× ▶</span></div><span class="kw-pro-dim">L pressed twice: forwards at 2×</span></div>
<div class="kw-pro kw-pro-panel kw-pro-tbar"><output class="kw-pro-tc kw-pro-tc--md">01<i>:</i>04<i>:</i>10<i>:</i>07</output><div class="kw-pro-transport" role="toolbar" aria-label="Program transport"><button class="kw-pro-btn" type="button" aria-label="Mark in (I)" title="Mark in (I)"><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="M14 4H9v16h5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Mark out (O)" title="Mark out (O)"><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="M10 4h5v16h-5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to in (Shift I)" title="Go to in (Shift I)"><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="M9 5H6v14h3M20 12h-9m3-3.5L10.5 12l3.5 3.5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Back one frame (Left arrow)" title="Back one frame (Left arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5 5h2v14H5zM19 5v14L8.5 12z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Play backwards (J)" title="Play backwards (J)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 4.5v15L5 12z"/></svg></button><button class="kw-pro-btn kw-pro-btn--play" type="button" aria-label="Pause (K)" title="Pause (K)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M6.5 4.5h4v15h-4zM13.5 4.5h4v15h-4z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Forward one frame (Right arrow)" title="Forward one frame (Right arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 5h2v14h-2zM5 5v14l10.5-7z"/></svg></button><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to out (Shift O)" title="Go to out (Shift O)"><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="M15 5h3v14h-3M4 12h9m-3-3.5 3.5 3.5-3.5 3.5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn" type="button" aria-pressed="false" aria-label="Loop playback (Command L)" title="Loop playback (Command L)"><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="M17 3l3 3-3 3M4 11V9a3 3 0 0 1 3-3h13M7 21l-3-3 3-3M20 13v2a3 3 0 0 1-3 3H4"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Add marker (M)" title="Add marker (M)"><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="M6 3h12v11l-6 6-6-6z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Match frame (F)" title="Match frame (F)"><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="8" height="7" rx="1"/><rect x="13" y="13" width="8" height="7" rx="1"/><path d="M11 7.5h3a3 3 0 0 1 3 3V13"/></svg></button></div><span class="kw-pro-sp"></span><span class="kw-pro-dim">Playing</span></div>

What it is

The deck controls of a viewer or a session. Editors drive it from the keyboard (J, K, L, I, O, arrows) and use the buttons to learn the keys or when a hand is on the mouse. The order is the one every editor’s muscle memory expects: marks on the outside, play in the middle, steps beside it.

When to use

  • Under every source and program viewer (the compact form, inside Video player).
  • Across the top of a sound session, where it drives the shared playhead.

When not to

  • In a phone review screen: show three 44px labelled buttons (back one frame, play, forward one frame) and nothing else.
  • For media that is not frame-based (a music player, a podcast): use a simple play control.

Anatomy in use

  • Marks: Mark in, Mark out. Go to in and Go to out sit beside the steps.
  • Steps and play: Back one frame, Play backwards, Play, Forward one frame. Play becomes Pause while running and is the only filled button.
  • Utilities: Loop (a toggle), Add marker, Match frame.
  • Shuttle gauge: nine stops from 8× backwards to 8× forwards. It shows what J and L have done, so a person who pressed L three times sees 4× and not a mystery.

Writing

Every button has a name that says the key: Mark in (I), Play backwards (J). The tooltip is the same text.

Play centred and filled, steps either side, marks at the ends, keys in every tooltip.

Do

A row of identical outline icons in a new order, with no tooltip and no shuttle speed.

Don’t

Anatomy

  1. Row: 32px tall, 4px padding, --k-pro-panel, 1px --k-pro-line; groups separated by a 1px × 16px rule.
  2. Buttons: 24 × 24px, 4px corners, 14px glyphs in --k-text-2; hover --k-pro-control and --k-text.
  3. Play: 28 × 24px, --k-text fill, --k-pro-on-tone glyph. The only filled control.
  4. Toggle on (Loop): --k-pro-control ground, 1px --k-pro-line-strong.
  5. Shuttle gauge: 9 cells, 22px tall, 11px figures; the current speed is filled with --k-pro-playhead; K (stop) is a letter in the middle.

Tokens

Token Light Dark
--k-pro-panel #f6f7f9 #19191b
--k-pro-control #ffffff #2a2a2e
--k-pro-line #d3d9e0 rgba(255, 255, 255, .09)
--k-text #0f172a #e3e3e3
--k-text-2 #5b6779 #9ca3af
--k-pro-playhead #c4502f #f28b71
--k-pro-on-tone #ffffff #1b221e
--k-radius-control 6px
--k-tap 44px

Numbers

Part Value
Row height 32px
Button 24 × 24px, glyph 14px
Play 28 × 24px
Gap 2px inside a group, 1px rule + 6px between groups
Under a thumb every button 44 × 44px; marks and utilities move into the ⋯ menu

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.

<div class="kw-pro kw-pro-panel kw-pro-tbar"><output class="kw-pro-tc kw-pro-tc--md">01<i>:</i>04<i>:</i>10<i>:</i>07</output><div class="kw-pro-transport" role="toolbar" aria-label="Program transport"><button class="kw-pro-btn" type="button" aria-label="Mark in (I)" title="Mark in (I)"><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="M14 4H9v16h5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Mark out (O)" title="Mark out (O)"><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="M10 4h5v16h-5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to in (Shift I)" title="Go to in (Shift I)"><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="M9 5H6v14h3M20 12h-9m3-3.5L10.5 12l3.5 3.5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Back one frame (Left arrow)" title="Back one frame (Left arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5 5h2v14H5zM19 5v14L8.5 12z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Play backwards (J)" title="Play backwards (J)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 4.5v15L5 12z"/></svg></button><button class="kw-pro-btn kw-pro-btn--play" type="button" aria-label="Play (Space or L)" title="Play (Space or L)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M7 4.5v15l12-7.5z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Forward one frame (Right arrow)" title="Forward one frame (Right arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 5h2v14h-2zM5 5v14l10.5-7z"/></svg></button><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to out (Shift O)" title="Go to out (Shift O)"><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="M15 5h3v14h-3M4 12h9m-3-3.5 3.5 3.5-3.5 3.5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn" type="button" aria-pressed="false" aria-label="Loop playback (Command L)" title="Loop playback (Command L)"><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="M17 3l3 3-3 3M4 11V9a3 3 0 0 1 3-3h13M7 21l-3-3 3-3M20 13v2a3 3 0 0 1-3 3H4"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Add marker (M)" title="Add marker (M)"><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="M6 3h12v11l-6 6-6-6z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Match frame (F)" title="Match frame (F)"><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="8" height="7" rx="1"/><rect x="13" y="13" width="8" height="7" rx="1"/><path d="M11 7.5h3a3 3 0 0 1 3 3V13"/></svg></button></div><span class="kw-pro-sp"></span><span class="kw-pro-dim">In → out</span><span class="kw-pro-tc">00<i>:</i>00<i>:</i>06<i>:</i>06</span></div>
<div class="kw-pro" style="display:flex;flex-wrap:wrap;gap:16px;align-items:center"><div class="kw-pro-shuttle" role="img" aria-label="Shuttle: playing forwards at 2 times"><span>◀ 8×</span><span>◀ 4×</span><span>◀ 2×</span><span>◀ 1×</span><span data-stop>K</span><span>1× ▶</span><span data-on>2× ▶</span><span>4× ▶</span><span>8× ▶</span></div><span class="kw-pro-dim">L pressed twice: forwards at 2×</span></div>
<div class="kw-pro kw-pro-panel kw-pro-tbar"><output class="kw-pro-tc kw-pro-tc--md">01<i>:</i>04<i>:</i>10<i>:</i>07</output><div class="kw-pro-transport" role="toolbar" aria-label="Program transport"><button class="kw-pro-btn" type="button" aria-label="Mark in (I)" title="Mark in (I)"><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="M14 4H9v16h5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Mark out (O)" title="Mark out (O)"><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="M10 4h5v16h-5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to in (Shift I)" title="Go to in (Shift I)"><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="M9 5H6v14h3M20 12h-9m3-3.5L10.5 12l3.5 3.5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Back one frame (Left arrow)" title="Back one frame (Left arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5 5h2v14H5zM19 5v14L8.5 12z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Play backwards (J)" title="Play backwards (J)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 4.5v15L5 12z"/></svg></button><button class="kw-pro-btn kw-pro-btn--play" type="button" aria-label="Pause (K)" title="Pause (K)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M6.5 4.5h4v15h-4zM13.5 4.5h4v15h-4z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Forward one frame (Right arrow)" title="Forward one frame (Right arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 5h2v14h-2zM5 5v14l10.5-7z"/></svg></button><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to out (Shift O)" title="Go to out (Shift O)"><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="M15 5h3v14h-3M4 12h9m-3-3.5 3.5 3.5-3.5 3.5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn" type="button" aria-pressed="false" aria-label="Loop playback (Command L)" title="Loop playback (Command L)"><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="M17 3l3 3-3 3M4 11V9a3 3 0 0 1 3-3h13M7 21l-3-3 3-3M20 13v2a3 3 0 0 1-3 3H4"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Add marker (M)" title="Add marker (M)"><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="M6 3h12v11l-6 6-6-6z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Match frame (F)" title="Match frame (F)"><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="8" height="7" rx="1"/><rect x="13" y="13" width="8" height="7" rx="1"/><path d="M11 7.5h3a3 3 0 0 1 3 3V13"/></svg></button></div><span class="kw-pro-sp"></span><span class="kw-pro-dim">Playing</span></div>

Behaviour

  • J: play backwards; pressed again 2×, 4×, 8×. L: the same forwards. K: stop. K held with J or L: slow (1/4×) in that direction. K held with ← / →: one frame.
  • The gauge and the Play/Pause button are one state; never let them disagree.

Keyboard

Key Does
Space Play / pause
J / K / L Backwards, stop, forwards; repeat J or L for 2×, 4×, 8×
← / → One frame back / forward
⇧ ← / ⇧ → One second back / forward
I / O Mark in / out; ⌥ I / ⌥ O clear
⇧ I / ⇧ O Go to in / out
⌘ L Loop on / off
M Add marker
F Match frame

ARIA

  • The row is role="toolbar" with an aria-label that names its viewer (Program transport); arrow keys move between buttons inside it.
  • Loop is a toggle with aria-pressed. Play announces Playing and Paused at 01:04:10:07 in a polite live region, never every frame.
  • The shuttle gauge is role="img" with the speed in words.

Rules

  • Must keep the order: marks, go to in, step back, play backwards, play, step forward, go to out.
  • Must put the shortcut in every button name and tooltip.
  • Always show shuttle speed and direction when J or L is pressed more than once.
  • Never fill any button except Play/Pause.
  • Always grow every transport button to 44px under a thumb.

AI readiness test

Task. Put a transport under the program viewer of a dailies tool.

Give the agent. Transport bar, Timecode display, Video player.

Constraint. Desktop and phone; phone has no keyboard.

A reliable answer

  • Desktop order marks–steps–play–steps–marks
  • Keys in names
  • Shuttle gauge for J/L
  • Phone shows only back one frame, play, forward one frame at 44px
  • Live region on play and stop only

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

Open .mdllms.txt
Loading…