close

Astryx

Mã nguồn mở bởi meta

Astryx là hệ thống thiết kế (design system) mã nguồn mở của Meta cho ứng dụng React. Bộ này gồm hơn 150 thành phần giao diện, 7 bộ giao diện có sẵn, chế độ tối, mẫu trang dựng sẵn và một CLI, được thiết kế để cả người lẫn trợ lý lập trình AI dùng chung một cách.

Astryx dùng để làm gì?

  • Dựng giao diện web React từ hơn 150 thành phần có sẵn, hỗ trợ trợ năng (accessible) và TypeScript
  • Đổi giao diện theo thương hiệu bằng 7 bộ giao diện có sẵn hoặc tự tạo bộ mới, có chế độ tối
  • Bắt đầu trang mới từ mẫu trang dựng sẵn thay vì viết từ đầu
  • Cho Claude Code, Codex, Cursor đọc hướng dẫn Astryx trong AGENTS.md / CLAUDE.md trước khi viết code giao diện
  • Tra tài liệu thành phần, token, mẫu trang ngay trong terminal hoặc dạng JSON cho trợ lý AI

Cần biết trước khi dùng

  • Lưu ýKhông tìm thấy docker-compose hay Dockerfile ở thư mục gốc: chưa thể gắn nút Deploy tự động.
  • Lưu ýDependency được khai báo theo khoảng phiên bản (ví dụ ">="), chưa tra lỗ hổng tự động được. Cần quét trên bản cài thật.
  • Lưu ýTino chưa kiểm thử dự án này.

Kiểm tra tự động ngày 23/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.

Astryx là gì?

Theo README, Astryx phát triển bên trong Meta suốt 8 năm và đang chạy trong hơn 13.000 ứng dụng của công ty, trước khi được mở mã nguồn theo giấy phép MIT. Thư viện xây trên React 19 và StyleX, nhưng người dùng chỉ cần nhập CSS dựng sẵn và các thành phần React có kiểu, không phải thêm plugin build. Muốn ghi đè kiểu thì dùng className với Tailwind, CSS modules hoặc CSS thường.

Điểm khác của Astryx là phần dành cho trợ lý lập trình AI. Lệnh init --features agents của CLI ghi một khối hướng dẫn vào AGENTS.md (và CLAUDE.md nếu dự án dùng Claude Code, dòng import trong GEMINI.md cho Gemini CLI). Khối này dạy trợ lý làm theo 3 bước: astryx build "" để chọn mẫu trang gần nhất, astryx template để dựng mẫu đó vào dự án, astryx component để đọc thuộc tính từng thành phần. Kèm theo là các quy tắc tránh lỗi thường gặp: bắt đầu trang từ mẫu, không dùng div trần, không viết style={{}} tay, dùng token thay cho giá trị cứng.

CLI là cách làm việc chính với Astryx: tìm kiếm thành phần, hook, tài liệu, mẫu trang và bộ giao diện trong một danh sách; mọi lệnh có tuỳ chọn --json trả dữ liệu có kiểu để trợ lý AI đọc. Lệnh swizzle chép toàn bộ mã nguồn một thành phần vào dự án khi cần tự sửa sâu.

Astryx đang ở bản Beta (dòng 0.7.x). Trước bản 1.0, các lần nâng cấp có thể đổi API; dự án dùng lệnh astryx upgrade --from --apply để chạy codemod sau khi nâng cấp.

Nên dùng khi

  • Bạn dựng ứng dụng React 19 và cần một bộ thành phần đồng bộ có sẵn bảng, form, điều hướng, mẫu trang
  • Bạn để Claude Code, Codex hoặc Cursor viết giao diện và muốn chúng theo một bộ quy ước thống nhất
  • Bạn cần đổi giao diện theo thương hiệu mà không phải sửa mã nguồn thành phần

Không nên dùng khi

  • Dự án chưa lên được React 19 (react và react-dom từ 19.0.0 là bắt buộc)
  • Sản phẩm cần API ổn định lâu dài: Astryx còn Beta, trước bản 1.0 các bản nâng cấp có thể đổi API
  • Bạn không dùng React (Vue, Svelte, Angular…)

Tính năng chính

  • Hơn 150 thành phần React có hỗ trợ trợ năng và TypeScript
  • 7 bộ giao diện có sẵn: neutral, butter, chocolate, matcha, stone, gothic, y2k
  • Chế độ tối và theme bằng CSS custom property, ghi đè được bằng className
  • Mẫu trang dựng sẵn cho trang bảng, trang chi tiết, form nhiều bước, điều hướng
  • CLI: search, component, docs, template, build, theme, swizzle, upgrade, có --json cho trợ lý AI
  • Lệnh init --features agents ghi hướng dẫn vào AGENTS.md / CLAUDE.md cho trợ lý lập trình
  • Swizzle: chép mã nguồn thành phần vào dự án để tự sửa

Cách cài đặt Astryx

  1. Cài Astryx, một bộ giao diện và CLI Cần React 19 trở lên (react và react-dom là peer dependency của @astryxdesign/core). README có lệnh tương đương cho pnpm và yarn.
    npm install @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex
    npm install -D @astryxdesign/cli
  2. Tạo hướng dẫn cho trợ lý AI Ghi hướng dẫn Astryx vào AGENTS.md ở thư mục dự án, và vào CLAUDE.md nếu dự án có file này. Lệnh không hỏi gì nên chạy được trong CI hoặc để trợ lý AI tự chạy.
    npx @astryxdesign/cli init --features agents
  3. Thêm bộ giao diện Tạo module app nhập CSS của bộ giao diện. Xem các bộ khác bằng npx @astryxdesign/cli theme list.
    npx @astryxdesign/cli theme add neutral
  4. Nhập CSS nền vào file CSS chung Đặt trong globals.css. Nếu dự án đã có Tailwind hoặc CSS reset riêng, đọc phần cascade layer trong npx @astryxdesign/cli docs migration/migration-setup trước.
    @import '@astryxdesign/core/reset.css';
    @import '@astryxdesign/core/astryx.css';
  5. (Tuỳ chọn) Cài CLI cho cả máy Lệnh astryx dùng được ở mọi thư mục cho bạn và mọi trợ lý lập trình. Trong dự án, CLI vẫn chạy đúng phiên bản của dự án.
    npm i -g @astryxdesign/cli

Lệnh chép từ README của dự án. Đọc kỹ trước khi chạy và đối chiếu với README mới nhất, vì lệnh có thể đổi theo phiên bản.

Cấu hình quan trọng

MụcÝ nghĩa
AGENTS.md / CLAUDE.mdFile hướng dẫn cho trợ lý AI do init --features agents ghi; khối nằm giữa hai dấu mốc Astryx, lệnh upgrade tự làm mới khối này
NO_UPDATE_NOTIFIERTắt việc CLI cài toàn máy kiểm tra bản mới trên npm
package.json → scripts.astryxREADME khuyên thêm script "astryx": "node node_modules/@astryxdesign/cli/clients/cli/bin/astryx.mjs" để trợ lý AI gọi CLI không bị sai đường dẫn

Cách tích hợp và sử dụng

  1. Bọc ứng dụng trong ThemeNhập themes và defaultThemeSlug từ module bộ giao diện vừa tạo, truyền themes[defaultThemeSlug] cho thành phần ở gốc ứng dụng.
  2. Nhờ trợ lý AI dựng trangSau khi chạy init, yêu cầu Claude Code hoặc Codex làm một trang (ví dụ trang bảng dữ liệu). Trợ lý sẽ chạy astryx build để chọn mẫu, astryx template để dựng mẫu, astryx component để tra thuộc tính.
  3. Tự tra cứuDùng npx @astryxdesign/cli search để tìm thành phần, hook, tài liệu, mẫu trang; npx @astryxdesign/cli component Button để xem thuộc tính và ví dụ.
  4. Kiểm tra trợ lý đã nắm quy ước chưaTrang Working with AI có bộ 3 câu hỏi kiểm tra (đường dẫn import Button, cách làm Dialog không đóng được, thuộc tính danh sách của Selector). Trợ lý trả lời sai thì chạy lại init.

Cập nhật và sao lưu

Nâng cấp mọi gói Astryx cùng lúc lên cùng một bản, ví dụ npm install @astryxdesign/core@latest @astryxdesign/theme-neutral@latest @astryxdesign/cli@latest, rồi chạy npx @astryxdesign/cli upgrade --from --apply để cập nhật code. Lệnh upgrade cũng làm mới khối hướng dẫn trong AGENTS.md / CLAUDE.md.

Nếu trình quản lý gói giữ lại bản mới (ví dụ minimumReleaseAge của pnpm), miễn trừ cả phạm vi @astryxdesign/* để không lẫn các gói khác bản.

Câu hỏi thường gặp

Astryx có miễn phí không?

Có. Mã nguồn theo giấy phép MIT. Gói được phát hành trên npm dưới phạm vi @astryxdesign.

Gõ npx astryx có được không?

Không nên. Tài liệu ghi rõ tên astryx không có phạm vi trỏ tới một gói npm khác không liên quan. Trước khi cài CLI, luôn gọi npx @astryxdesign/cli; sau khi cài vào dự án thì dùng pnpm exec astryx hoặc npm run astryx.

Có bắt buộc dùng StyleX trong code của mình không?

Không. Astryx dùng StyleX bên trong và phát hành CSS dựng sẵn; bạn ghi đè bằng className với Tailwind, CSS modules hoặc CSS thường. Gói @stylexjs/stylex vẫn phải cài vì là peer dependency.

Biểu đồ có sẵn chưa?

Theo README, @astryxdesign/charts và @astryxdesign/vega mới phát hành trên npm dưới thẻ @canary, chưa có bản ổn định.

Có cần VPS để dùng Astryx không?

Không. Astryx là thư viện cài vào dự án React trên máy lập trình. Ứng dụng dựng xong thì triển khai như mọi ứng dụng React khác.

Ứng dụng liên quan

Miễn trừ trách nhiệm

Tino không phát triển, không sở hữu và không liên kết với Astryx hay nhóm phát triển meta. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.

Astryx được phân phối theo giấy phép MIT của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.

Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.