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.
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.
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.
npm install @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex
npm install -D @astryxdesign/clinpx @astryxdesign/cli init --features agentsnpx @astryxdesign/cli theme add neutral@import '@astryxdesign/core/reset.css';
@import '@astryxdesign/core/astryx.css';npm i -g @astryxdesign/cliLệ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.
| Mục | Ý nghĩa |
|---|---|
AGENTS.md / CLAUDE.md | File 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_NOTIFIER | Tắt việc CLI cài toàn máy kiểm tra bản mới trên npm |
package.json → scripts.astryx | README 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 |
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ó. 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.
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.
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.
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.
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.
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.