# AI consent prompt

> Before anything a person writes leaves the device: what is sent, to whom, what is kept, and a choice that starts off.

Source: https://kwark.space/designSystem/components/ai-consent

## Usage

### What it is
The question Kwark asks before any feature sends a person’s words off the device, once per project, with the switch starting **off**. Kwark has one such opt-in: *Smart phonetic suggestions* (Decision 0046), which asks an online input service for better candidates for the word being typed. *Copy for AI* on a character page follows the same idea from the other side: *Choose what travels*, nothing ticked until the writer ticks it, and *The exact prompt you’ll share* in full before it is copied.

### When to use
- The first time a feature in a project would send anything out.
- Again whenever what is sent, to whom or what is kept changes; say what changed.

### When not to use
- Before the person has reached for the feature: never on first run (Decision 0034).
- For student accounts, until the guardian-consent work exists: no feature may send a student’s work to an outside AI service ([AI and authorship](https://kwark.space/designSystem/foundations/ai-and-authorship.md)).
- As a wall of legal text. Four facts in plain words; the policy is a link.

### Writing
- The title is a question with the feature and the project: *Turn on smart phonetic suggestions for Blank Pages?*
- Four facts, each true for the service actually used: what is sent, to whom, what is kept, where it applies.
- Yes names its scope: **Turn on for Blank Pages**. No is **Not now**, with no guilt line.

## Style

### Anatomy

1. **Dialog**: the story dialog (14px corners, `--k-bg`, 1px `--k-line`), 480px.
2. **Title**: Raleway `--k-fs-display`, 400.
3. **Facts**: a definition list; terms 12px Poppins 600, answers 14px.
4. **Switch**: the editor’s `.ui-switch` at 38 × 22px, off.
5. **Actions**: quiet *Not now*, primary *Turn on for Blank Pages*.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-bg` | #f8fafc | #191919 |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-accent` | #98633f | #98633f |
| `--k-accent-soft` | #e8b58b | #e8b58b |
| `--k-on-accent` | #ffffff | #ffffff |
| `--k-radius-sheet` | 14px |  |
| `--k-fs-display` | 28px |  |
| `--k-font-display` | 'Raleway', 'Poppins', system-ui, sans-serif |  |
| `--k-fs-meta` | 12px |  |

## 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
<div class="kw-ai-consent" role="dialog" aria-label="Turn on smart phonetic suggestions for Blank Pages?">
  <h2>Turn on smart phonetic suggestions for Blank Pages?</h2>
  <p>Off until you turn it on. Phonetic typing works without it, from tables on this device.</p>
  <dl class="kw-ai-consent__facts">
    <div><dt>What is sent</dt><dd>The word you are typing, in Roman letters, while this is on.</dd></div>
    <div><dt>To whom</dt><dd>An online dictionary input service, named in this setting.</dd></div>
    <div><dt>What is kept</dt><dd>Kwark keeps only the word you choose, in your script. Your work is never used to train anything.</dd></div>
    <div><dt>Where it applies</dt><dd>This project only. Turn it off in Settings › Writing at any time.</dd></div>
  </dl>
  <label class="kw-ai-consent__switch"><span>Smart phonetic suggestions</span><button class="kw-ui-switch" type="button" role="switch" aria-checked="false" aria-label="Smart phonetic suggestions"><i></i></button></label>
  <div class="kw-ai-consent__acts"><button class="kw-button kw-button--quiet" type="button">Not now</button><button class="kw-button kw-button--primary" type="button">Turn on for Blank Pages</button></div>
</div>
```

## Accessibility

### Keyboard
| Key | Does |
|---|---|
| Tab | Switch, Not now, Turn on. |
| Escape | Same as Not now; nothing is turned on. |

### ARIA
- `role="dialog"` named by its question; in the app, link the first sentence with `aria-describedby`. Focus starts on *Not now*, so a stray Enter never says yes.

## For agents

### Rules

- **Must** start off; never pre-enable anything that sends work out.
- **Must** say what is sent, to whom, what is kept and where it applies, for the service actually in use.
- **Never** offer it on a student account until guardian consent exists.
- **Always** focus Not now first and treat Escape as no.
- **Never** use a person’s work to train or tune a model.

### AI readiness test

**Task:** Ask before the storyboard pack's prompt is copied for an outside image tool.

**Give the agent:** This page, Foundations › AI and authorship (the AI storyboard pack), the Copy for AI dialog.

**Constraint:** The pack would include casting photos.

**A reliable answer:**
- Starts with nothing selected
- Lists the photos and scenes that would travel and shows the exact prompt
- Names that the person's chosen tool receives it, not Kwark
- Focuses Not now first
- Leaves private research out unless added
