Kwark. Design System
Open Kwark

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.

ComponentsAI and authorshipReady for Kwark
<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>

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

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

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

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.

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

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

Open .mdllms.txt
Loading…