Kwark. Design System
Open Kwark

Quick note

A pen in the corner and a card to write on that leaves the page where it is. The note remembers where it came from.

ComponentsCreative toolsIn the app
<button class="kw-quick-note-pen" type="button" aria-label="Quick note" aria-expanded="true"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12 20h9M16.5 3.5a2.1 2.1 0 1 1 3 3L7 19l-4 1 1-4z"/></svg></button>
<div class="kw-quick-note" role="dialog" aria-label="Quick note">
  <div class="kw-quick-note__head">
    <div class="kw-quick-note__title"><strong>Quick note</strong><span class="kw-quick-note__from">From Scene 12 · INT. EDIT SUITE – NIGHT</span></div>
    <button class="kw-icon-button" type="button" aria-label="All quick notes"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20V3H6.5A2.5 2.5 0 0 0 4 5.5z"/></svg></button>
    <button class="kw-icon-button" type="button" aria-label="Close"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 6 6 18M6 6l12 12"/></svg></button>
  </div>
  <textarea class="kw-quick-note__text" aria-label="Note">The frame should be from a camera that was never on the kit list.</textarea>
  <div class="kw-quick-note__foot"><span role="status">Saved</span><button class="kw-button kw-button--sm" type="button">Done</button></div>
</div>

When to use

When a thought arrives while the person is doing something else: an idea for Act 3 while scheduling, a prop while reading. The note card floats; the page under it does not move. Each note records where it was written (“From Scene 12”), and lands in Research as a team note by default (memory: research personal workspaces).

When not to

  • For comments on someone else’s work. Use a Comment pin, which is attached to a line and visible to others.
  • For tasks with owners and dates.

Phones

The pen is the phone’s one floating control (Decision 0011, 0016). It sits 16px from the edge; pages reserve --k-fab-slot so it never covers the last row. Never add a second floating button for anything else; add an item to the pen’s sheet.

Anatomy in use

  • Pen: 44px disc, the project colour on the surface; filled when the note is open.
  • Card: 400px, 18px corners, a 3px ribbon of the project colour along the top, floating shadow.
  • From line: the place the note came from.
  • Foot: save word and Done. All notes and New note are in the head.

Writing

The from line names the place in the writer’s terms: From Scene 12 · INT. EDIT SUITE – NIGHT, From the call sheet, Day 4.

One pen; the card opens over the page and says where the note came from.

Do

A second floating button for “Add idea”, or a note that navigates away from the page to open.

Don’t

Anatomy

Pen .kw-quick-note-pen 44px; card .kw-quick-note (head 12px × 18px, textarea 14px/1.7, foot with 1px top line).

Tokens

Token Light Dark
--k-surface #ffffff #1a1a1a
--k-accent #98633f #98633f
--k-accent-soft #e8b58b #e8b58b
--k-line #e2e8f0 rgba(255, 255, 255, .1)
--k-shadow-pop 0 1px 2px rgba(15, 23, 42, .06), 0 12px 32px rgba(15, 23, 42, .12) 0 2px 6px rgba(0, 0, 0, .2), 0 16px 36px rgba(0, 0, 0, .55)
--k-tap 44px

React

In the Kwark app: import QuickNotes from '@/components/quickNotes/QuickNotes'.

<QuickNotes />  // mounted once in the app shell
Prop Type Notes

HTML and CSS

Works anywhere with kwark.css.

<button class="kw-quick-note-pen" type="button" aria-label="Quick note" aria-expanded="true"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12 20h9M16.5 3.5a2.1 2.1 0 1 1 3 3L7 19l-4 1 1-4z"/></svg></button>
<div class="kw-quick-note" role="dialog" aria-label="Quick note">
  <div class="kw-quick-note__head">
    <div class="kw-quick-note__title"><strong>Quick note</strong><span class="kw-quick-note__from">From Scene 12 · INT. EDIT SUITE – NIGHT</span></div>
    <button class="kw-icon-button" type="button" aria-label="All quick notes"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20V3H6.5A2.5 2.5 0 0 0 4 5.5z"/></svg></button>
    <button class="kw-icon-button" type="button" aria-label="Close"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 6 6 18M6 6l12 12"/></svg></button>
  </div>
  <textarea class="kw-quick-note__text" aria-label="Note">The frame should be from a camera that was never on the kit list.</textarea>
  <div class="kw-quick-note__foot"><span role="status">Saved</span><button class="kw-button kw-button--sm" type="button">Done</button></div>
</div>
  • The card is a non-modal dialog: focus moves to the textarea and returns to the pen on Done or Escape.
  • The pen is named “Quick note” and reports aria-expanded.
  • The save word is a polite status.

Rules

  • Never add a second floating control on a phone; the pen is the one.
  • Must keep the page under the note where it was.
  • Always record where a note was written.

AI readiness test

Task. Let a director jot a note from the call sheet on a phone.

Give the agent. Quick note, Floating dial, Phones pattern, Decision 0016.

Constraint. The call sheet already has the pen.

A reliable answer

  • Uses the existing pen
  • Note says From the call sheet, Day 4
  • Page does not move
  • No second floating button

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

Open .mdllms.txt
Loading…