一本可以被實作的設計語言。 跨專案共用的設計 token、通用元件參考實作， 以及後台系統的操作模式手冊。
- 📘 文件站：https://kielchang.github.io/dooping-design-book/
- 🧩 Storybook：https://kielchang.github.io/dooping-design-book/storybook/
- 📦 Registry：
https://kielchang.github.io/dooping-design-book/r/<name>.json - 🤖 機器地圖（給 AI）：https://kielchang.github.io/dooping-design-book/llms.txt
萃取自一套真實運作的內部後台系統，只保留與產業無關的部分： 設計語言、通用元件、以及那些「每個系統都會遇到、而且通常會想錯一次」的操作邏輯。
三層，相依強度刻意遞減：
| 層 | 內容 | 取用方式 |
|---|---|---|
packages/tokens |
設計 token（色彩語意、間距、字級、動態…） | 唯一建議 npm 安裝的一層 |
packages/react |
React 參考實作（項目清單見 /r/index.json） |
registry 複製原始碼進你的專案 |
book/docs/4-patterns |
操作模式（問題→做法→取捨→反例） | 讀懂，用你自己的技術棧實作 |
理由：元件一定會被改，token 幾乎不會。 詳見 ADR-0004 與 ADR-0005。
npm install # 安裝 workspace 相依
npm run build:tokens # 產生 tokens.css 與 tokens.data.ts（後續步驟的前提）
npm run storybook # http://localhost:6006
npm --prefix book start # 文件站 http://localhost:3000第二行不能跳過。
dist/不進版控，而packages/tokens/dist/tokens.css是 測試（tests/tokens.test.ts直接讀它）、Storybook 與文件站三者的硬相依—— 乾淨 clone 之後不先產生它，這三樣都會失敗。 Claude Code 的.claude/hooks/session-start.sh會自動處理；Node 版本見.nvmrc。
packages/
├── tokens/ @dooping/tokens — tokens.json（來源）→ CSS 變數 ＋ Tailwind preset ＋ TS API
└── react/ @dooping/react — React 參考實作（元件 ＋ stories ＋ 示範資料）
registry/ shadcn registry JSON（由 scripts/build-registry.mjs 產生）
book/ Docusaurus 文件站（中文搜尋、可列印、內嵌真元件）
docs/adr/ 決策紀錄正本（build 時同步到文件站）
tests/ 守衛測試（7 支）：邊界、token、色彩、去領域化、示範資料、文件掛鉤、宿主基座
.storybook/ Storybook 設定
npm run build:tokens # token 產物（其他步驟的前提）
npm run typecheck # TypeScript
npm test # 守衛測試（7 檔）
npm run verify:color # 六主題 × 兩模式的對比／色覺／互動狀態層門檻
npm run build-storybook # Storybook
npm run build:registry # registry JSON
npm --prefix book run build # 文件站（onBrokenLinks: throw）在這個 repo 裡開發的完整約定（色彩值是生成的、版號要同步三處、去領域化閘門、
截圖驗證的方法論）見 CLAUDE.md；
系統怎麼組起來（管線、守衛、CI 閘門的全貌）見 ARCHITECTURE.md。
packages/react 的元件走 registry 複製散佈，不會被大量 npm install；
workspace 的功能需求只有「本地 symlink ＋ 一次安裝」。
npm workspaces 已經滿足，而且不需要在每個 CI／每台機器多裝一個套件管理器。
book/ 刻意不是 workspace 成員：Docusaurus 與 Storybook 的相依樹很大，
分開安裝可以避免版本互相牽制，也讓文件站能單獨建置。
- 去領域化 —— 拿掉原始產業脈絡還成立嗎？
- 通用性 —— 換一個後台系統會用到嗎？
- 三次法則 —— 實際用過三次以上且穩定才收。投機性抽象不收。
第 1 條由 tests/de-domain.test.ts 自動把關，零容忍。
見 ADR-0006。
三種回饋，三個門口（詳見 CONTRIBUTING.md）：
MIT