Kwark. Design System
Open Kwark

Location card

A candidate place for a scene's location: photo, status from Idea to Locked, address and what it costs.

ComponentsMediaIn the app

Edit suite, locked Rooftop, searching Street, nothing yet

Edit suite, locked Rooftop, searching Street, nothing yet

<div class="kw-locations">
  <article class="kw-location" data-status="locked"><button class="kw-location__open" type="button"><span class="kw-location__photo"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-5-5L5 21"/></svg><span class="kw-location__status">Locked</span></span><span class="kw-location__body"><strong>Lumen Studios, Stage 2</strong><small>for EDIT SUITE · Scenes 12, 15</small><span class="kw-location__meta"><span>Andheri East</span><span>45,000 a day</span></span></span></button></article>
  <article class="kw-location" data-status="recce"><button class="kw-location__open" type="button"><span class="kw-location__photo"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-5-5L5 21"/></svg><span class="kw-location__status">Recce</span></span><span class="kw-location__body"><strong>Old Film Lab rooftop</strong><small>for ROOFTOP · Scene 13</small><span class="kw-location__meta"><span>Recce Tue 19, 16:00</span></span></span></button></article>
  <article class="kw-location" data-status="dropped"><button class="kw-location__open" type="button"><span class="kw-location__photo"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-5-5L5 21"/></svg><span class="kw-location__status">Dropped</span></span><span class="kw-location__body"><strong>Hotel terrace</strong><small>for ROOFTOP · Scene 13</small><span class="kw-location__meta"><span>No night permits</span></span></span></button></article>
</div>
<p class="kw-meta" style="display:flex;gap:8px;align-items:center"><span class="kw-place-dot" data-progress="locked"></span>Edit suite, locked <span class="kw-place-dot" data-progress="searching"></span>Rooftop, searching <span class="kw-place-dot"></span>Street, nothing yet</p>

When to use

In Locations: each place the script names (EDIT SUITE, ROOFTOP) has candidates, each a card. Locking a candidate shortlists any other lock for the same place, so a place has one locked location.

When not to

  • For the story’s places in the World module. Those are fiction; this is a real address.
  • For reference photos without a candidacy. Use the Media grid.

Statuses

Idea, Recce, Shortlist, Locked, Dropped. Locked has a green edge; Dropped fades to 55% and stays, because the reason it was dropped matters next time. The place list beside the cards shows a dot: red ring (nothing yet), amber (searching), green (locked).

Writing

The card says what it is for in the script’s terms: for EDIT SUITE · Scenes 12, 15. Dropped cards keep the reason: No night permits.

Lumen Studios, Stage 2 · Locked · for EDIT SUITE · 45,000 a day.

Do

Three cards marked Locked for the same scene location.

Don’t

Anatomy

Grid of 240px minimum. Photo 16:10 with a hatched empty state; status label top left; body 10px × 12px with 15px name.

Tokens

Token Light Dark
--k-raise #f1f5f9 #252525
--k-surface #ffffff #1a1a1a
--k-line #e2e8f0 rgba(255, 255, 255, .1)
--k-ok #2c6e49 #6cc08a
--k-warn #8a5a00 #d8a44a
--k-danger #b4382c #e0685c
--k-strip-ink #1f2427
--k-paper #fbfbf8

React

In the Kwark app: import LocationsPage from '@/pages/PreProduction/LocationsModule/LocationsPage'.

// .po-candidate; statuses in shared/locations.ts LOCATION_STATUSES
Prop Type Notes
status 'idea' | 'recce' | 'shortlist' | 'locked' | 'dropped' locking one unlocks the previous lock for the same place

HTML and CSS

Works anywhere with kwark.css.

<div class="kw-locations">
  <article class="kw-location" data-status="locked"><button class="kw-location__open" type="button"><span class="kw-location__photo"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-5-5L5 21"/></svg><span class="kw-location__status">Locked</span></span><span class="kw-location__body"><strong>Lumen Studios, Stage 2</strong><small>for EDIT SUITE · Scenes 12, 15</small><span class="kw-location__meta"><span>Andheri East</span><span>45,000 a day</span></span></span></button></article>
  <article class="kw-location" data-status="recce"><button class="kw-location__open" type="button"><span class="kw-location__photo"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-5-5L5 21"/></svg><span class="kw-location__status">Recce</span></span><span class="kw-location__body"><strong>Old Film Lab rooftop</strong><small>for ROOFTOP · Scene 13</small><span class="kw-location__meta"><span>Recce Tue 19, 16:00</span></span></span></button></article>
  <article class="kw-location" data-status="dropped"><button class="kw-location__open" type="button"><span class="kw-location__photo"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-5-5L5 21"/></svg><span class="kw-location__status">Dropped</span></span><span class="kw-location__body"><strong>Hotel terrace</strong><small>for ROOFTOP · Scene 13</small><span class="kw-location__meta"><span>No night permits</span></span></span></button></article>
</div>
<p class="kw-meta" style="display:flex;gap:8px;align-items:center"><span class="kw-place-dot" data-progress="locked"></span>Edit suite, locked <span class="kw-place-dot" data-progress="searching"></span>Rooftop, searching <span class="kw-place-dot"></span>Street, nothing yet</p>
  • The card is one button opening the candidate; status is in its text.
  • The place dots are paired with words.

Rules

  • Must allow only one locked candidate per scripted place.
  • Always keep dropped candidates and their reason.
  • Must name the scripted place on each card.

AI readiness test

Task. Lock the rooftop candidate after the recce.

Give the agent. Location card, Budget top sheet, Call sheet.

Constraint. Another candidate was locked earlier.

A reliable answer

  • New candidate Locked
  • Previous moves to Shortlist
  • Budget line follows the new cost per day
  • Call sheet location updates in the draft only

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

Open .mdllms.txt
Loading…