Kwark. Design System
Open Kwark

Feedback control

Asks whether one of Kwark’s own tools helped: Useful or Not useful, with an optional note. Never placed on a person’s writing.

ComponentsFeedbackReady for Kwark
<div class="kw-feedback" role="group" aria-label="Was this export useful?">
  <span aria-hidden="true">Was this export useful?</span>
  <button class="kw-feedback__opt" type="button" aria-pressed="false">Useful</button>
  <button class="kw-feedback__opt" type="button" aria-pressed="true">Not useful</button>
</div>
<label class="kw-field kw-feedback__note"><span class="kw-label">What was missing? (optional)</span><input class="kw-input" placeholder="Scene numbers were not on the side"></label>

What it is

A two-word question about Kwark itself: an export, a help page, a suggestion the assistant made. The answer goes to the people who build Kwark, not to anyone in the project.

When to use

  • At the end of a tool’s result: an exported PDF, a breakdown the app read from the script, an AI result someone has finished reviewing.

When not to use

  • On a scene, a line, a character, a draft or anything a person made. Kwark never judges the script (Decision 0002) and is a safe, private place (Decision 0001).
  • As stars, numbers, scales or emoji. Two words.
  • More than once per session for the same tool.

Writing

Was this export useful? · Useful · Not useful. After an answer: Thanks. What was missing? (optional). Never Rate.

Anatomy

  1. Question: 12px Poppins, --k-text-2.
  2. Options: 28px pills, 0 10px, 1px --k-line, 12px, --k-text-2 (the same shape as the calendar’s person choices, .tl-person). Pressed: border --k-accent-soft, background color-mix(--k-accent 14%), --k-text.
  3. Note: appears after Not useful; optional, one line.

Tokens

Token Light Dark
--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-radius-pill 999px
--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-feedback" role="group" aria-label="Was this export useful?">
  <span aria-hidden="true">Was this export useful?</span>
  <button class="kw-feedback__opt" type="button" aria-pressed="false">Useful</button>
  <button class="kw-feedback__opt" type="button" aria-pressed="true">Not useful</button>
</div>
<label class="kw-field kw-feedback__note"><span class="kw-label">What was missing? (optional)</span><input class="kw-input" placeholder="Scene numbers were not on the side"></label>

Keyboard

Key Does
Tab Moves to each option.
Enter / Space Chooses it; the note field appears and is not focused automatically.

ARIA

  • A role="group" named by the question; options are toggle buttons with aria-pressed.

Rules

  • Never attach feedback controls to a person’s writing or any project content (Decisions 0001, 0002).
  • Never use stars, scores, scales or emoji.
  • Must make the follow-up note optional.
  • Always say who sees the answer if it is not obvious: the Kwark team.

AI readiness test

Task. Add a way for writers to rate the outline templates.

Give the agent. This page, Decisions 0002 and 0004.

Constraint. The product team wants a 1–5 rating.

A reliable answer

  • Uses Useful / Not useful, not 1–5
  • Places it on the template picker, not on the writer’s outline
  • Makes the note optional

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

Open .mdllms.txt
Loading…