Skip to content

design.v1 — 1.1.0

Choose a tag to compare

@HKTITAN HKTITAN released this 06 Aug 16:06
· 1 commit to main since this release

The .design contract grows a voice, a committed aesthetic, and full current-ecosystem interop — plus CI-enforced validation and an annotated starter template.

New in the format

  • voice — the UI copy contract: register, casing, terminology map, action-name continuity, error style. Applied with the same force as tokens (SPEC §13C).
  • Committed intentintent.direction (named aesthetic), intent.signature (the one element where boldness concentrates), intent.treatment (utilitarian | editorial) with per-surface patterns.<name>.treatment overrides.
  • Nested token groups (depth ≤ 20) with full dot-path refs, token→token reference chains (depth ≤ 10), tokens.background atmosphere group, motion/spring tokens, typography font stacks + fallbacks.
  • policy.color.accent_cycle, generalized decisions.* (token-role rules like decisions.typography), themes.single, designed-not-inverted mode rule, CSS mode-emission strategy.
  • Reading tiers for large files; targets object form with environment constraints (external_assets: false, single_file).

Interop

  • shadcn/ui, current model — styles (vegasera, new-york legacy), primitive base (base | radix | react-aria), icon_library, presets, namespaced/private registries (never-guess rule), MCP, full variable set (chart-1…5, sidebar-*), css_vars.theme, Tailwind v4 @theme inline, and exports.shadcn_registry — ship your brand as an installable registry:theme item.
  • Google DESIGN.md — lossless import verified against 0.4.0: nesting, version-field semantics, radius export units, omitted namespaces, CLI interop table.

Quality

  • Schema hardened: flat component property bags validate, variantswhen/when_not enforced, typed token groups.
  • scripts/lint_design.py in CI: schema validation of every example, WCAG contrast checks, alias-collision detection, reference resolution, instruction-duty coverage — plus a leak guard.
  • Massively expanded craft bar in the portable skill (typography/color-scale numbers, iconography, gestures, performance, information architecture, default-looks-to-avoid catalogue) and a plan → critique → confirm → write bootstrap.
  • templates/starter.design — annotated kitchen-sink contract: copy as .design, replace values, go.

Full details: CHANGELOG.

🤖 Generated with Claude Code