Home

Astryx Wiki

Astryx is a design system for building internal tools. This wiki documents the architecture, the conventions, and the protocols behind it.

Each section below links the pages you need first. The deeper material is linked from those pages, not from here.

Start here

• Astryx Philosophy — Why Astryx exists, what we learned, and the principles that emerged
• Contributing with AI Assistants — How to contribute with Navi or another AI assistant. Start here if you're new.
• Contributing — How contributions work, what we accept, the RFC process, and what to expect

Architecture

• System Architecture — Customization layers, tokens, AI-native design
• Architecture Cheat Sheet — Minimal component template and shared-system lookup for authors and reviewers
• Theming Infrastructure — defineTheme, CSS custom properties, layer ordering, subcomponent overrides
• Distribution — Packages, versioning, source and dist bundles, pre-compiled CSS

Deeper: Container Padding System · Chart System Architecture · Docsite Architecture · Why StyleX · RSC Compatibility

Building a component

• Component Lifecycle — The end-to-end guide: specification → build → hardening → maintenance. The individual protocols are linked from it.
• Component Authoring Guide — File structure, StyleX patterns, token usage, and conventions
• API Conventions — Naming, props, composition, and styling conventions for all components
• Design Conventions — Visual and interaction conventions: the intention behind token choices, state representations, and how design quality is evaluated

Quality

• Component Audit Rubric — The graded checklist: eleven weighted sections and what counts as evidence. Reviewing a PR? Its guidance on reviewing a change sets the bar by change type and never runs the whole checklist on a diff.
• Accessibility Checklist — The ten-item accessibility bar; a hard requirement for graduating a component to core

Operations

• Release Process — Changesets, codemods, version bumps, publishing
• Night Watch Overview — Automated repo stewardship during off-hours; the roles are linked from it

Also

Vibe Tests — the three vibe-testing workflows · Contributing Templates — full-page templates for the sandbox and CLI · Research Archive — historical explorations and forward-looking research

---

Note: For component-specific documentation, see the {Name}.doc.mjs file in each component's directory under packages/core/src/. Run astryx component <Name> to view formatted docs.