open-design/design-systems
Tom Huang 56aa985b1a
feat(design-systems): integrate kami as editorial paper system + deck starter (#226)
* feat(design-systems): integrate kami as editorial paper system + deck starter

- Add design-systems/kami/DESIGN.md adapting kami's tokens, ten invariants,
  and type/color/component rules into the OD DESIGN.md spec. Lands under a
  new "Editorial & Print" category in the picker.
- Add templates/kami-deck.html: a kami-flavored variant of deck-framework.html
  (parchment canvas, ink-blue accent, single-weight serif) with five demo
  slides — cover, agenda, metric row, two-column body+pull-quote, closing —
  so it doubles as a worked example for slide and prototype work.
- Update design-systems/README.md and README.md to list and credit kami
  (MIT, tw93/kami).
- Update apps/web/src/i18n/content.ts so the i18n coverage test passes:
  add the German summary for 'kami' and the 'Editorial & Print' category.

* docs(design-systems/kami): address PR #226 review notes

Five P3 polish edits from @lefarcen's review (LGTM, non-blocking):

1. Add a "When to swap the stack" subsection in §3 spelling out how the
   three CJK font stacks combine: set the dominant-language stack on
   :root, scope per-section overrides for mixed-language artifacts,
   never chain all three families inside one font-family declaration.

2. Reframe the brand as "kami / 紙 / 纸" so the system reads as
   co-designed across EN, zh-CN, and ja from the start, not Japan-centric
   with i18n bolted on. Title and §1 lede updated.

3. Reconcile the pt → px ratios into one table at the top of §3
   "Hierarchy": print pt × ~1.33 for page artifacts, × 1.6 for slide
   macro tokens, × 0.6 for slide micro tokens. Drop the duplicate
   ratio bullets from §5 "Slides".

4. Keep the soft tag-brush gradient exception but make it real: add
   the .tag.brush CSS + an inline <span class="tag brush"> example
   in §4, and surface it once on slide 04 of the kami deck so agents
   see exactly when the carve-out applies.

5. Add a "Tabular-nums contexts" subsection in §3 enumerating every
   place numbers should opt into tabular-nums (metrics, footers,
   section numbers, dates, financial tables, KPI grids, version
   numbers, side-by-side comparisons) — and the rule for when not to
   (single numbers in running prose).
2026-05-02 11:00:56 +08:00
..
agentic update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
airbnb Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
airtable Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
ant update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
apple Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
application update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
artistic update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
bento update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
binance Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
bmw Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
bold update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
brutalism update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
bugatti Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
cafe update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
cal Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
claude Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
clay Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
claymorphism update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
clean update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
clickhouse Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
cohere Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
coinbase Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
colorful update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
composio Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
contemporary update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
corporate update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
cosmic update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
creative update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
cursor Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
dashboard update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
default Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
dithered update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
doodle update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
dramatic update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
editorial update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
elegant update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
elevenlabs Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
energetic update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
enterprise update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
expo Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
expressive update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
fantasy update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
ferrari Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
figma Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
flat update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
framer Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
friendly update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
futuristic update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
glassmorphism update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
gradient update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
hashicorp Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
ibm Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
intercom Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
kami feat(design-systems): integrate kami as editorial paper system + deck starter (#226) 2026-05-02 11:00:56 +08:00
kraken Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
lamborghini Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
levels update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
linear-app Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
lingo update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
lovable Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
luxury update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
mastercard Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
material update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
meta Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
minimal update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
minimax Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
mintlify Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
miro Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
mistral-ai Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
modern update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
mongodb Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
mono update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
neobrutalism update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
neon update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
neumorphism update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
nike Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
notion Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
nvidia Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
ollama Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
opencode-ai Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
pacman update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
paper update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
perspective update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
pinterest Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
playstation Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
posthog Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
premium update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
professional update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
publication update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
raycast Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
refined update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
renault Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
replicate Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
resend Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
retro update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
revolut Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
runwayml Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
sanity Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
sentry Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
shadcn update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
shopify Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
simple update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
skeumorphism update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
sleek update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
spacex Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
spacious update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
spotify Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
starbucks Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
storytelling update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
stripe Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
supabase Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
superhuman Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
tesla Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
tetris update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
theverge Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
together-ai Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
uber Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
vercel Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
vibrant update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
vintage update: add 57 DESIGN.md files from awesome-design-skills (#92) 2026-05-01 16:57:25 +08:00
vodafone Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
voltagent Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
warm-editorial Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
warp Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
webflow Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
wired Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
wise Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
x-ai Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
xiaohongshu docs(xiaohongshu): address review feedback from #24 (#54) 2026-05-01 10:38:19 +08:00
zapier Add initial project structure with essential files 2026-04-28 12:25:59 +08:00
README.md feat(design-systems): integrate kami as editorial paper system + deck starter (#226) 2026-05-02 11:00:56 +08:00

Design Systems

Each subfolder is a portable design system in DESIGN.md format. Pick one in the top-bar Design system dropdown and every skill will read it as part of its system prompt.

What's bundled

  • default/ — Neutral Modern. Hand-authored starter for the OD spec.
  • warm-editorial/ — Warm Editorial. Hand-authored serif starter.
  • kami/ — 紙 / 纸. Editorial paper system distilled from tw93/kami (MIT). Warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. Pairs with the templates/kami-deck.html starter for slide work.
  • 57 design skills, sourced from bergside/awesome-design-skills and added directly as normalized 9-section DESIGN.md files.
  • 70 product systems, imported from VoltAgent/awesome-design-md (the getdesign@latest npm package, MIT-licensed). One folder per brand:
    Category Systems
    AI & LLM claude · cohere · elevenlabs · minimax · mistral-ai · ollama · opencode-ai · replicate · runwayml · together-ai · voltagent · x-ai
    Developer Tools cursor · expo · lovable · raycast · superhuman · vercel · warp
    Productivity & SaaS cal · intercom · linear-app · mintlify · notion · resend · zapier
    Backend & Data clickhouse · composio · hashicorp · mongodb · posthog · sanity · sentry · supabase
    Design & Creative airtable · clay · figma · framer · miro · webflow
    Fintech & Crypto binance · coinbase · kraken · mastercard · revolut · stripe · wise
    E-Commerce & Retail airbnb · meta · nike · shopify · starbucks
    Media & Consumer apple · ibm · nvidia · pinterest · playstation · spacex · spotify · theverge · uber · vodafone · wired · xiaohongshu
    Automotive bmw · bugatti · ferrari · lamborghini · renault · tesla

Folders use ASCII slugs — dotted brands are normalized (linear.applinear-app, x.aix-ai, etc.).

File shape

The first H1 is the title shown in the picker. The line immediately after the H1 is parsed for > Category: <name> and used to group the dropdown:

# Design System Inspired by Cohere

> Category: AI & LLM
> Enterprise AI platform. Vibrant gradients, data-rich dashboard aesthetic.

## 1. Visual Theme & Atmosphere
...

Both the boilerplate prefix Design System Inspired by and the > Category: ... line are stripped from the dropdown label and the summary preview at runtime — they're only metadata.

Adding your own

Drop a new folder containing a DESIGN.md and it shows up on next refresh. Add a > Category: <Group> line to slot it under an existing group, or use any new label and it lands at the bottom of the dropdown.

Refreshing the bundled set

The 70 product systems are pulled from the upstream npm package. To re-sync to the latest hashes:

curl -sL $(npm view getdesign dist.tarball) -o /tmp/getdesign.tgz
tar -xzf /tmp/getdesign.tgz -C /tmp
node --experimental-strip-types scripts/sync-design-systems.ts

For now, the original importer lives at the top of the excessive-climb branch — re-run it against a fresh tarball.

Attribution

The 70 product systems are sourced from VoltAgent/awesome-design-md (MIT, © VoltAgent contributors). They are aesthetic inspirations — none of them are official assets of the brands they reference.

The kami/ system adapts tokens, type rules, and the "ten invariants" from tw93/kami (MIT, © Tw93 and contributors), a Claude skill for typesetting professional documents and slide decks.

The 57 design skills are sourced from bergside/awesome-design-skills.