# 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.

Source: https://kwark.space/designSystem/components/quick-note

## Usage

### 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](https://kwark.space/designSystem/components/comment-pin.md), 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*.

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

**Don't:** A second floating button for "Add idea", or a note that navigates away from the page to open.

## Style

### 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 |  |

## Code

### React

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

```tsx
<QuickNotes />  // mounted once in the app shell
```

| Prop | Type | Notes |
|---|---|---|

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<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>
```

## Accessibility

- 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.

## For agents

### 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
