There was an error while loading. Please reload this page.
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 [[...]].
Name the human design review instead of the bare 'L3', and link it
Fix every piped wiki link: GitHub treats the text after the pipe as the page name
Correct radius role tokens, CLI and sandbox paths, and the renamed templates gallery route
Correct the CLI asset paths: templates and docs live under packages/cli/assets
Delete the superseded hardening and auditor pages; repoint every link at the rubric
Component auditor: one component a night, audit-fix-reaudit, ledger as the only state, no issues
Wiki-wide: drop the mode-letter shorthand for plain language
Reroute links from the collapsed auditor sections to the rubric Design Conventions, API Conventions, the Accessibility Checklist, Component Lifecycle and the Night Watch role summary all pointed at auditor sections that no longer exist. Each now points at the rubric section that carries the check, with the convention pages still owning what the rule is.
Fix remaining stale token names across the wiki --size-sm/md/lg, spacingTokens.space3, --shadow-menu, --radius-rounded and the --text-* raw scale do not exist on main; the token objects are *Vars maps keyed by CSS custom property name.
docs: document lab→core and hidden→visible template promotion gates
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.