Skip to content

feat(design): refinement roadmap from 4-source skill study + P-SHADOW recipes - #457

Merged
jackwener merged 1 commit into
mainfrom
design/roadmap-and-shadow-recipes
Jul 3, 2026
Merged

feat(design): refinement roadmap from 4-source skill study + P-SHADOW recipes#457
jackwener merged 1 commit into
mainfrom
design/roadmap-and-shadow-recipes

Conversation

@jackwener

Copy link
Copy Markdown
Member

Part 1: 设计路线图(文档)

系统学习了四个设计 skill 源(taste-skill / superdesign / ui-skills.com 生态 / vercel-labs agent-skills),对照 2026-06-24 已 shipped 的 skills 轮提炼真增量,沉淀为 docs/design-refinement-roadmap-2026-07.md

  • 四个已拍板路线决策:4pt 系统 > 像素对标 / dark 一等公民 / 动效快而准 / 暂不做签名元素
  • 四源精华 × maka 适用清单(subtle layering、同心圆角、三层阴影、duration 分级表、四档文字层级、对比度硬线、工程质量清单)
  • 明确不采纳清单(CJK 特例:中文禁收紧 letter-spacing、破折号不是 AI-tell 等)
  • 落地队列 P-SHADOW → P-STATE,每项独立 PR 双主题验收

Part 2: P-SHADOW(队列第一项)

Light:三个 recipe 的 blur 层原是纯黑 rgba(0,0,0,…) —— taste-skill 禁令:浅色暖灰壳上的纯黑阴影读作污渍。全层改为 oklch(from var(--foreground)) 派生,ring/blur/文字共享同一光源。透明度不变。

Dark(决策 D2):blur 堆叠在暗壳上不可见但仍耗合成,且前景派生层在 dark 下变白发光。dark 的 elevation 改由 border ring 承载(interface-design:"dark mode shadows collapse to a single ring"),modal 保留一层深投影维持与 backdrop 的分离。

验证

  • turn-narrative + settings-general 双主题 fixture 截图
  • npm --workspace @maka/desktop test: 1685/1685

… recipes

Docs: docs/design-refinement-roadmap-2026-07.md distills a systematic
study of four design-skill sources (taste-skill, superdesign,
ui-skills.com ecosystem incl. emil-design-eng / interface-design /
impeccable / make-interfaces-feel-better, vercel-labs agent-skills /
web-interface-guidelines) against what maka already shipped in the
2026-06-24 skills round. It records the four owner decisions (4pt
spacing system over pixel-parity; dark mode as a first-class theme;
fast-and-precise motion personality; no signature element yet) and an
ordered delivery queue (P-SHADOW ... P-STATE), plus an explicit
"not adopting" list with CJK adaptations.

Code: P-SHADOW, the first queue item.
- Light recipes: every blur layer in --shadow-minimal/-medium/-modal
  was pure-black rgba. On the warm gray shell a pure black shadow
  reads as a smudge (taste-skill ban: shadows must carry the surface
  hue). All layers now derive from the warm foreground via
  oklch(from var(--foreground)) so ring, blur, and ink share one
  light source. Opacities unchanged.
- Dark collapse (decision D2): blur stacks are invisible-but-costly
  on a dark shell, and foreground-derived layers turn white-ish and
  glow. Dark mode now carries elevation with border rings
  (minimal/flat/medium), modal keeps one deep drop for backdrop
  separation.

Verified with light+dark fixture screenshots (turn-narrative,
settings-general); desktop suite 1685/1685.
@jackwener
jackwener merged commit e74893a into main Jul 3, 2026
@jackwener
jackwener deleted the design/roadmap-and-shadow-recipes branch July 3, 2026 06:32
jackwener added a commit that referenced this pull request Jul 3, 2026
…TE) (#460)

All eight queue items resolved across #457/#458/#459: four landed as
code (shadow recipes + dark collapse, input inset step-down,
concentric radii, 4pt ratchet + text tier cleanup) and four audited
as already-compliant or covered (motion durations, dark semantics,
state coverage). Records next-round candidates.
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