History / Contributing

Home: reorganize into six sections with progressive disclosure Home listed 40 links across 7 sections while leaving 19 pages unlinked, so it was neither short nor complete. The hub pages that carry each cluster already exist (Component Lifecycle, Vibe Tests, Night Watch Overview, Research Archive); Home now points at them instead of duplicating their contents. - Home: 15 top-level links in Start here / Architecture / Building a component / Quality / Operations / Also. Nothing removed from the wiki — every demoted page is one click deeper behind a hub that lists it. - Add _Sidebar.md so the same navigation renders on every page. - Re-home the four pages Home was the only link to: Blog Review Rubric and Testing Example Apps from Contributing, Hardening Audit Guide from Component Lifecycle. Zero orphans after the change. - Fix the Contributing with AI Assistants link in Release Process, broken by a line wrap inside the [[...]].

Fix every piped wiki link: GitHub treats the text after the pipe as the page name

Delete the superseded hardening and auditor pages; repoint every link at the rubric

Delete the superseded hardening and auditor pages; repoint every link at the rubric

Add Design Conventions page Design-side sibling of API Conventions: the intention behind token choices (foundations), standard state representations across component archetypes, and how design quality is evaluated. - Wire the Contributing Design Review section and Home index to the new page - Component Auditor gains a Design Conventions dimension for the objectively-checkable rules (spacing grid, concentric radius, contrast, type hierarchy, motion safety, stacking); subjective visual judgment stays in Hardening Layer 3

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.