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 mainJul 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 freeto 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

@jackwener
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
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 mainJul 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 freeto 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

@jackwener
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
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 mainJul 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 freeto 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

@jackwener
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
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 mainJul 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 freeto 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

@jackwener
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
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 mainJul 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 freeto 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

@jackwener
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
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 mainJul 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 freeto 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

@jackwener
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
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 mainJul 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 freeto 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

@jackwener
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
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 mainJul 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 freeto 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

@jackwener