History / Component Authoring Guide

Architecture: publish component cheat sheet and refresh references

Correct the .doc.mjs type import: @astryxdesign/cli/authoring, not a relative docs-types path

Correct the container padding variables: three directional vars, no isotropic or block form

Teach ref as a prop instead of forwardRef Main is React 19 ref-as-prop: 149 core components declare ref on their props interface, @eslint-react/no-forward-ref is enabled, and exactly one forwardRef call site remains (lab's RichTextEditor).

Update the authoring guide to the shipped token and theming APIs Tokens are defineVars maps indexed by the CSS custom property name (colorVars['--color-*'], spacingVars, sizeVars, durationVars, easeVars), not colorTokens.surface / spacingTokens.space3 / transitionTokens.fast. Overrides are consumed through the themeProps class, not useContext(ThemeContext) and a ComponentStyles interface that does not exist. The animation examples no longer hardcode 0.6s and ease-out.

Stories live in apps/storybook/stories, not beside the component There are no *.stories.tsx files under packages/; all 180 live in apps/storybook/stories/<Name>.stories.tsx. Also drops the stale claim that components are named Astryx{ComponentName}, which the table below contradicts.

Update wiki for XDS → Astryx rename Refresh outdated references across all wiki articles to match the current codebase after the XDS → Astryx rebrand: - Package scope @xds/* → @astryxdesign/* (theme-default/theme-daily → theme-neutral; ESLint rule → @astryx/*) - CLI command xds → astryx; fix stale commands (build-theme → theme build, agent-docs folded into init) - CSS/layers: xds.css → astryx.css, @layer xds → @layer astryx-base, @layer xds.theme → @layer astryx-theme - Config key "xds" → "astryx"; env var XDS_THEME → ASTRYX_THEME - Repo facebookexperimental/xds → facebook/astryx; versions 0.0.15 → 0.1.1 - Swizzle output dir components/xds/ → components/astryx/ - API rename xdsThemeProps → themeProps (verified against source) - Asset set xds_oss → astryx (browse via internalfb.com/assets/set/astryx) - Correct component-purity docs: components are unprefixed (no "Astryx" prefix) Co-authored-by: Cursor <cursoragent@cursor.com>

Astryx design system wiki Documentation for the Astryx design system: API conventions, component authoring, theming, RSC utilities, Night Watch automation, and contribution guides.