淺色與深色,同一份 markup
模式切換的是 token 值,不是 class 名稱。拖曳分隔線,看看目前用的是哪個值。
介面樣式
主題、token、廣色域色彩、版面與動態都寫成 class,產生的 CSS 也始終可預期。
定義你的主題 token模式切換的是 token 值,不是 class 名稱。拖曳分隔線,看看目前用的是哪個值。
在 @theme 定義一次顏色、間距、圓角與排版,utilities、元件與模式都從這裡讀取。
@theme { --font-family-sans: "Inter"; --spacing-md: 1rem; /* p-md */ --spacing-lg: 1.5rem; /* p-lg */ --radius-xl: 0.75rem; /* r-xl */ /* bg-surface-base */ --color-surface-base: light-dark( var(--color-zinc-0), var(--color-zinc-95) );}Utility 位於比元件更後的串接層,因此標記中的 class 不需要 !important 就能優先套用。
P3 色盤採用可預期的色階,從深色基調到超出 sRGB 的明亮強調色。
編輯器
語言服務依你的 manifest 補全 class,hover 時顯示每個 class 背後的 CSS,並直接標出顏色。
使用方向鍵閱讀完整檔案。
渲染
可選擇靜態、預先渲染或執行階段傳遞,class 寫法維持相同。
比較渲染模式掃描原始碼中完整的 class 名稱。把對應的規則寫入 app.css。在頁面繪製前載入樣式表。
讀取渲染完成的頁面 HTML 中使用的 class。把對應的規則嵌入頁面。使用隨 HTML 一起送達的 CSS 繪製頁面。
在瀏覽器中讀取頁面使用的 class。啟動 runtime,建立樣式表。在瀏覽器中產生並套用規則。
CSS 大小
每個頁面載入的 CSS,分別以原始大小與 Brotli 壓縮計算。Master CSS 只加入頁面用到的 utilities,其餘是各網站自己的樣式。
查看效能測試細節每個文件頁的 CSS · 2026-11-04
程式碼檢查
編輯器裡的 ESLint、腳本中的 CLI,以及給 agent 的 MCP 伺服器,都用同一套規則與修正檢查 class。
查看所有 lint 規則<button class="inline-flex (color:12px)"> Save changes</button>@master/css/no-invalid-classes 1:28
$ npx @master/css-cli lint --format stylish1:28error@master/css/no-invalid-classes
→ mastercss_lint_content button.html"ruleId": "no-invalid-classes","severity": "error","loc": { "start": { "line": 1, "column": 28 } }
AI agents
MCP 伺服器把你的 manifest 與 lint 規則交給 coding agent,讓它們檢查自己的修改,並以 diff 交給你修正。
設定 MCP 伺服器mastercss_manifest_query 12 個 token{ "kind": "token", "namespace": "spacing" } spacing-4xs … spacing-5xlplan-card.html+3 −3mastercss_inspect_class matched{ "className": "bg-surface-raised" } background-color: var(--color-surface-raised)mastercss_lint_project 4 個問題{ "patterns": ["plan-card.html"] } 4 個警告,4 個可自動修正mastercss_preview_fixes 1 file changed{ "patterns": ["plan-card.html"] } confirmToken "Vq3zK8…Ug6J"mastercss_apply_preview 已套用{ "confirmToken": "Vq3zK8…Ug6J" } 雜湊相符,已寫入檔案mastercss_lint_project 沒有問題{ "patterns": ["plan-card.html"] } 0 個問題mastercss_lint_project沒有問題
plan-card.htmlsha256 4e0a1aab…c9c0開發流程
一份專案 manifest 驅動每個整合、monorepo app 與路由的 CSS,snapshot 比對則顯示一次變更觸及哪些地方。
依你的框架安裝每個框架整合與 CLI 都載入同一份專案 manifest,建置與編輯器的結果因此一致。
每個檔案跟隨最近的專案,同一個 class 在不同 app 可以解析成不同的值。
index.css路由樣式表可使用共用的 token、mixin 與 custom media,不必複製全域規則。
.hero { display: grid; gap: var(--spacing-5xl); @media (--md) { grid-auto-flow: column; }}.plan { padding: var(--spacing-lg); @apply --raised; @media (--md) { padding: var(--spacing-5xl); }}.post { max-width: 42rem; padding: var(--spacing-lg); @media (--md) { @apply --raised; }}修改 token 後比對 snapshot,就能看到它影響的 class、檔案與輸出。