Build with us
A friendly community of designers and engineers shaping the system together.Your name could be next.See contributors
How we build together
Contributing to Astryx means contributing to the system, not to a single component. Each step has a clear gate, so you always know what comes next.01
Share a proposal
Describe the problem you ran into and what you think should change. We respond within a week.02
Shape it together
We co-explore research, use cases, and design options until the right shape becomes obvious.03
Ship it experimentally
New components ship in @xds/lab first, where the team and real users put them through their paces.04
Make it official
Once battle-tested and refined, the work graduates from @xds/lab into @xds/core for everyone to use.Fix a bug
Spot something broken? File an issue to confirm it, then submit a change with a clear reproduction.~2 hours
Improve the docs
Fix typos, improve examples, and fill gaps. Reviewed for correctness and clarity.~30 min
Resources
Communications
Contributing
- Contributing GuideThe full process, what we accept, and how proposals get reviewed.
- Contributing with AIHow to use AI assistants effectively within Astryx conventions.
- Dev SetupClone, install, build, and run Storybook locally.
- API ConventionsHow components in Astryx are named, shaped, and composed.
- API ArbitrationHow we settle design disagreements using vibe testing.

