Skip to content

Add Kilo design tokens and playground#1

Merged
Drixled merged 6 commits into
mainfrom
feat/tokens-and-playground
Jun 17, 2026
Merged

Add Kilo design tokens and playground#1
Drixled merged 6 commits into
mainfrom
feat/tokens-and-playground

Conversation

@Drixled

@Drixled Drixled commented Jun 16, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Add the canonical hand-authored tokens.json for the current dark-first Kilo design token contract.
  • Add a local Next.js token playground for previewing, editing, saving, and validating the token system.
  • Refresh the root README with current repo status, token contract notes, and playground run instructions.

Validation

  • node -e 'JSON.parse(require("fs").readFileSync("tokens.json","utf8")); console.log("json ok")'
  • pnpm build && npx tsc --noEmit from playground/

Drixled and others added 6 commits June 9, 2026 18:02
Re-author tokens.json as the shared contract: hand-authored flat HEX
(ADR 0003), primary === brand === #EDFF00 with near-black foreground
(ADR 0005), split into mode-agnostic brand/status and dark-only
surface/foreground/border buckets with no light-mode set (ADR 0009),
plus status domain map, type scale, spacing, radius, and shadows.

Add a Next.js playground (playground/) to tailor the tokens live: an
exhaustive control rail for every token leaf, an in-context dark
stickersheet gallery, a collapsible JSON preview panel, OKLCH preview
via culori, and a local-dev-only API route that writes edits back to
the canonical tokens.json.
- Rework the playground shell: semantic status pill, save loading state,
  reload-source guard for unsaved edits, grouped pane toggles, and
  responsive overlay drawers with full hover/focus/reduced-motion states.
- Add a token filter to the left rail with label associations and an
  empty state for faster token editing.
- Wrap the JSON preview to avoid horizontal scroll; copy lives in the pane.
- Build into .next-build so a smoke build never clobbers a running dev server.
- Remove the $comment documentation keys from tokens.json (values unchanged).
- Add sticky scrollspy section nav to the gallery (Foundations /
  Components groups with granular jump items) so sections are reachable
  without one long scroll.
- Remove shadow tokens from tokens.json and all playground consumers
  (type, flatten, controls group, gallery section, CSS); replace dead
  --shadow-overlay var refs with literal values.
- Fix brand.primary drift (#e0e0e0 -> #EDFF00) per ADR 0005
  (primary === brand === neon yellow-green).
- Make swatch labels wrap instead of clipping; commit inline hex edits
  only on valid hex (blur/Enter), fixing janky live editing.
…r shortcuts

- Move color swatches into the left controls rail (compact, borderless, 2px radius)
- Convert gallery to independent tabs instead of one scrollspy page
- Add realistic mockups: settings form (all input types), mini editor, bigger
  inline diff, chat with tool-call cards — modeled on kilo-cloud/kilo-code
- Replace marketing-style type scale with a devtools-grounded one: drop display,
  rename h1/h2/h3 to title/heading/subheading, add bodySmall/caption/micro/codeSmall
- Restyle active tab as an underline instead of a brand-primary pill
- Add Cmd+. (Ctrl+.) to toggle both side panels together
- Remove primaryDim; refresh stale brand fallbacks to the #F7F586 scale
…ckups

- Surfaces: add inset (sunken) + selected, rename muted->hover, drop
  secondary/control fills; even out hover (#3A3A3A) vs selected (#454545)
- Add live Surfaces tab specimen (ramp + mini app) driven by surface tokens
- Type scale: chat/editor/diff/tool code unified on the code role; chat prose
  and empty-state on body; bodyLg kept as the 1rem anchor (unused in examples)
- Homogenize editor/diff/chat: borderless, separated by surface value only
- Borderless cards/forms/inputs; swatches in left rail; tabs full-width
- Sweep stale var() fallbacks (radius-sm, eyebrow, surface) to current values
- Wire Agentation toolbar (dev-only)
@Drixled Drixled merged commit 827e427 into main Jun 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant