Meta 於 2026 年一月把內部使用八年的 Astryx 設計系統開源,採 MIT 授權、TypeScript 撰寫。該系統曾支撐一萬三千個以上應用,開源版提供一百五十餘個無障礙元件、七套可換主題與命令列工具,建基於 React 19 與 StyleX,目前累積約一萬九千星標。

Astryx 儲存庫 README 開頭,頂部為 Meta 官方 Astryx 橫幅與專案名稱,下方標語說明此為開源設計系統並同時服務人類與 AI 代理,並列出 npm 版本、MIT 授權、文件站、Storybook 與沙盒入口徽章

Astryx 是什麼?

Astryx 是 Meta 開源的設計系統,採 MIT 授權,內含一百五十餘個無障礙元件、七套主題與命令列工具,建基於 React 19 與 StyleX。

專案在 Meta 內部成長八年,長期是該公司使用量最大、規模最大的設計系統。官方在說明中給出的數字是一萬三千個以上應用依賴此系統,涵蓋內部工具、後台介面與面向客戶的產品。

開源版並非把內部程式碼整份倒出。專案重新整理為四個發布套件,分別是負責元件與主題的核心套件、提供文件與脚手架的命令列工具、處理 StyleX 原始碼建置的外掛,以及七套獨立主題包,另有一份實驗元件保留在內部使用。

儲存庫目前約一萬九千星標、一千四百餘次複製,主要語言為 TypeScript,另有部分 Swift 與 CSS。專案仍標示為測試階段,最新版本為 2026 年十一月七日的 0.7.11,累計發布四十五個版本。

為什麼 Meta 要把內部設計系統開源?

官方理由是開發方式已改變。設計系統同時服務人與代理,把 API、文件與命令列一起開放,能讓外部團隊以同一套規範建置,並把元件慣例沉澱成可共同檢驗的標準。

README 的敘述把重點放在協作對象的變化。元件庫過去只需對設計師與前端工程師負責,現在還要對 coding agent 負責,因此 API 命名、文件結構與工具介面必須一起設計,否則代理只能靠猜測。

這個立場反映在具體決定上。元件慣例寫成明文規則,文件對每個元件的屬性、變體與範例都有固定格式,命令列可直接輸出結構化 JSON,代理與人讀到的參考來源是同一份。

商業誘因同樣存在。Meta 近年把 React、StyleX 等前端基礎設施開源,Astryx 延續這條路線。對該公司而言,外部採用者會回報議題與提交修補,設計系統的維護成本由社群分擔。

元件與主題架構有何特別?

元件以可組合為前提設計,底層建構塊直接匯出,需要改動時可把原始碼退出到專案。主題為 CSS 自訂屬性覆寫,改外觀不必包裝元件。

StyleX 是 Meta 自家的樣式方案,但專案刻意不把它變成採用門檻。消費端只需匯入預先編譯的 CSS,即可使用型別化的 React 元件,不必安裝建置外掛,也不必配置 PostCSS 或 Babel。

樣式覆寫走既有的 className 路徑。專案現有使用 Tailwind、CSS Modules 或純 CSS 的團隊,可直接以原本方式覆寫樣式,不需要為採用 Astryx 而改動整條樣式管線。

主題機制沿用設計權杖的做法。七套預設主題包含中性、奶油、巧克力、抹茶、石材、哥德與千禧風,每套都是 CSS 變數的集合,設計師調整變數即可改寫配色、圓角與字級,不必碰元件原始碼。

命令列工具如何讓 AI 代理參與開發?

執行 init 會把元件索引寫入 AGENTS.md 或 CLAUDE.md,代理由此得知元件清單與屬性,並可查詢文件、輸出模板與執行升級 codemod。

這是專案最具體的新意。多數元件庫假設使用者會開瀏覽器讀文件,Astryx 則假設使用者可能是一個沒有瀏覽器的代理程式,因此把文件本身做成可程式呼叫的介面。

實際用法是安裝命令列後執行初始化,工具會把元件目錄與使用規範寫進專案根目錄的代理設定檔。此後代理在撰寫介面時,讀到的是專案內已安裝版本的實際元件清單,而非模型記憶中的舊版 API。

命令列另提供搜尋與單一元件查詢。搜尋會同時比對元件、勾子、文件主題與頁面模板,結果標註領域與後續指令;版本升級則以 codemod 方式改寫既有程式碼,減少跨版本遷移的手工調整。

與其他元件庫相比有何差異?

差異在三處:元件內部可組合並可整份退出、樣式不鎖定單一方案、文件與工具同時對人與代理設計。這三點讓它在既有專案中的導入摩擦較低,但生態規模仍遠小於成熟元件庫。

主流元件庫多以封閉的高階 API 為賣點,使用者透過屬性控制外觀與行為,遇到邊界需求時只能等待上游支援。Astryx 的取向相反,它把底層建構塊直接匯出,並允許把單一元件原始碼退出到專案內自行維護。站內過去整理過 Ant Design 6 與 Material UI 10,兩者均屬前一種路線。

代價是學習曲線。可組合意味著更多決策落在使用端,元件不會替使用者擋掉不合規的組合。官方在原則章節中明確承認這一點,並以「提供能力而非護欄」描述其設計立場。

生態規模仍是最大差距。專案累積四十五個版本、貢獻者逾百人,但第三方元件與整合案例遠少於老牌元件庫。對於需要大量現成範本的團隊,現階段仍需自行補足,可先參考 shadcn/ui 的元件分發模式 作為對照。

19,065Stars
1,462Forks
150+元件數量
7預設主題
TypeScript主要語言
MIT授權條款

Astryx 儲存庫首頁程式碼檢視,顯示 Code、Issues、Pull requests 等分頁,左側檔案樹列出 apps、packages 與 internal 三個目錄,右側 About 欄說明開源設計系統定位,並顯示一萬九千星標與一千四百餘次複製統計

採用時需要注意哪些限制?

專案仍屬測試階段,版本為 0.x,API 可能變動。圖表套件未有穩定版,且安裝命令列必須使用 @astryxdesign 範圍名。

版本號是最直接的風險指標。0.7.11 意味著專案尚未承諾語意化版本,跨小版可能出現不相容變更。官方提供 codemod 工具處理遷移,但遷移成本仍落在採用者身上。

發布範圍亦有界線。實驗元件套件只在內部使用,圖表相關套件僅以 canary 標籤發布,尚無穩定版本。需要圖表能力的專案,現階段需另行選型。

安裝環節存在一個容易踩到的陷阱。命令列必須以 @astryxdesign/cli 範圍名呼叫,若直接執行未加範圍的 astryx,會解析到 npm 上另一個無關套件。官方在文件中特別標註此事,並建議在專案內加入 npm script 固定路徑。

出處連結有哪些?

原始碼、版本標籤與完整變更記錄公開於 GitHub,文件站另提供 Storybook 與沙盒。專案採 MIT 授權,可自由用於商業產品,無需回饋修改。

儲存庫位於 https://github.com/meta/astryx ,文件站為 astryx.atmeta.com,內含元件示範、主題展示與可即時編輯的沙盒環境。每個版本在 releases 頁附有變更摘要與升級指令。

授權條款為 MIT,允許閉源整合與商業使用,僅需保留版權聲明。對於需要在內部產品線統一介面規範的團隊,這是採用門檻最低的授權形式之一。

Astryx 儲存庫貢獻者統計頁面,上方為近月提交頻率圖表,下方依提交次數排列貢獻者卡片,顯示 Meta 內部團隊與外部社群貢獻者的提交分布

總結:哪些團隊適合採用 Astryx?

已在用 React 19 且樣式方案多元的團隊最適合,代理輔助開發流程者收益更明顯。若專案重度依賴穩定 API 或需要現成圖表元件,宜等專案脫離測試階段再評估。

此專案的核心訊號是設計系統的服務對象正在擴張。當代理成為實際的程式碼生產者,文件的可程式讀取程度、命令列的結構化輸出,與元件慣例的一致程度,都會直接影響產出品質。

對既有專案而言,導入成本集中在觀念轉換而非技術整合。樣式管線可沿用,建置流程無需外掛,主要工作是熟悉元件組合慣例與主題覆寫方式。

對於正在建立代理輔助開發流程的團隊,Astryx 提供了一個可觀察的樣本。它示範如何把設計規範寫成代理可讀的形式,這部分經驗即使最終不採用此元件庫,仍有參考價值。