Skip to content

v2.3.0 — Design Judgment: Playbooks, Visual Craft & Scoring

Latest

Choose a tag to compare

@bitjaru bitjaru released this 15 Jun 04:57
· 26 commits to main since this release

This release is about design judgment — teaching the engine not just rules, but taste: how to bias those rules for the kind of app and screen you're building, the research-backed craft that makes a component look intentional, and how to keep a whole UI coherent.

New: two axes of judgment

  • APP-PLAYBOOKS.md — how to bias the rules for the app's domain (fintech, SaaS, e-commerce, social, content, productivity, health, dev-tools, …). A fintech dashboard and a social dashboard apply the same rules differently.
  • PAGE-TYPES.md — how to bias for the screen type (dashboard / form / landing / detail / list / settings / onboarding). Domain × page-type = the actual judgment.

New: VISUAL-CRAFT.md — research-backed craft + Coherence Laws

The "design sense" layer, made concrete and sourced (Refactoring UI, Material 3, Apple HIG, IBM Carbon, WCAG 2.2, FT Visual Vocabulary, Butterick, NN/g, Tufte):

  • §C0 Coherence Laws — one choice per axis (radius / shadow / accent / spacing / icons / type / motion), applied system-wide. The antidote to "AI-generated UI looks off": pick a corner personality and keep everything on it.
  • Spacing & rhythm · typography (+ type recipe by app type) · component craft (layered shadows, the nested-radius law, buttons/cards/inputs/icons/states) · color & dark mode · data-viz · 2025–26 trends (durable vs fad).

Rules: 69 → 74

DESIGN-LANGUAGE.md gains §70 Form & Input · §71 States · §72 Accessibility · §73 Responsive & Mobile · §74 Rule Priority & Conflict Resolution.

Skills: 14 → 15

  • /ss-score — score a UI 0–100 across weighted categories with a prioritized fix list. Now includes a Coherence category.
  • /ss-review — new §8 Coherence checklist (one-choice-per-axis, nested radius).

Web

  • /guides — 8 programmatic design guides by app type, each surfacing the domain's type recipe (typeface / hero / body / numerals) and corner personality.

MIT licensed. ⭐ https://github.com/bitjaru/styleseed