astryx init foolproof: @astryxdesign/core postinstall nudge by josephfarina · Pull Request #4155 · facebook/astryx

josephfarina · 2026-07-22T00:46:28Z

Enforcement layer 1 of 3 — and the highest-impact, since installing the design system is the common fresh-install entry point. When @astryxdesign/core is installed and the project hasn't run init, its postinstall prints a one-line next-step.

Independent of the CLI-side PRs (separate package) — can land on its own.

What

packages/core/scripts/postinstall.mjs prints Next step: run npx @astryxdesign/cli init …. Never fails the install.
Self-contained: core can't import the CLI, so the agent-doc locations + marker mirror the CLI's single source of truth (agent-docs.mjs: AGENT_DOC_PATHS + MARKER_START) — kept in sync + covered by a guardrail test (all 6 locations incl. Hermes + legacy XDS).
Quiet in the monorepo/source build, during npx's transient fetch, and once set up.
Message: the validated simple one-liner, identical across all 3 layers.

Tests

packages/core/src/postinstall.test.mjs — marker detection across all locations + nudge decision matrix.

vercel · 2026-07-22T00:46:33Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
astryx	Ready	Preview, Comment	Jul 22, 2026 3:58am

github-actions · 2026-07-22T01:40:15Z

PR Analysis Report

📚 Storybook Preview

View Storybook for this PR
GitHub Pages may take up to a minute to hydrate after deploy.

🧪 Sandbox Preview

View Sandbox for this PR
GitHub Pages may take up to a minute to hydrate after deploy.

No new or modified components detected.

Bundle Size Summary

Package	Size (ESM)	Size (CJS)	Gzipped
@astryxdesign/core	N/A	4.7KB	0B

Accessibility Audit

Status: 67 accessibility violation(s) found — 6 critical, 55 serious, 6 moderate.

AppShell - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 9/10 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Avatar - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/12 stories · Learn more
- WCAG: 1.4.3 (Level AA)

AvatarGroup - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/12 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Badge - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/5 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Banner - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/15 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Card - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 7/13 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Carousel - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 8/8 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Chat - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/8 stories · Learn more
- WCAG: 1.4.3 (Level AA)

ChatComposer - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/14 stories · Learn more
- WCAG: 1.4.3 (Level AA)

ChatComposerInput - 2 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 4/14 stories · Learn more
- WCAG: 1.4.3 (Level AA)
🔴 critical: Ensure an element's role supports its ARIA attributes
- Rule: aria-allowed-attr · Affects 8/14 stories · Learn more
- WCAG: 4.1.2 (Level A)

ChatLayout - 1 issue(s)

🔴 critical: Ensure an element's role supports its ARIA attributes
- Rule: aria-allowed-attr · Affects 2/3 stories · Learn more
- WCAG: 4.1.2 (Level A)

ChatReasoning - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 4/5 stories · Learn more
- WCAG: 1.4.3 (Level AA)

ChatToolCalls - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 10/11 stories · Learn more
- WCAG: 1.4.3 (Level AA)

CheckboxList - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 6/16 stories · Learn more
- WCAG: 1.4.3 (Level AA)

ClickableCard - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/5 stories · Learn more
- WCAG: 1.4.3 (Level AA)

CodeEditor - 2 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 3/7 stories · Learn more
- WCAG: 1.4.3 (Level AA)
🟠 serious: Ensure elements that have scrollable content are accessible by keyboard in Safari
- Rule: scrollable-region-focusable · Affects 1/7 stories · Learn more
- WCAG: 2.1.1, 2.1.3 (Level A)

CodeEditorPerf - 2 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/2 stories · Learn more
- WCAG: 1.4.3 (Level AA)
🟠 serious: Ensure elements that have scrollable content are accessible by keyboard in Safari
- Rule: scrollable-region-focusable · Affects 2/2 stories · Learn more
- WCAG: 2.1.1, 2.1.3 (Level A)

CodeEditorTheme - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 14/14 stories · Learn more
- WCAG: 1.4.3 (Level AA)

CodeTheme - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 14/16 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Collapsible - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/10 stories · Learn more
- WCAG: 1.4.3 (Level AA)

DateRangeInput - 1 issue(s)

🔴 critical: Ensure an element's role supports its ARIA attributes
- Rule: aria-allowed-attr · Affects 1/16 stories · Learn more
- WCAG: 4.1.2 (Level A)

FileInput - 3 issue(s)

🟠 serious: Ensure interactive controls are not nested as they are not always announced by screen readers or can cause focus problems for assistive technologies
- Rule: nested-interactive · Affects 12/14 stories · Learn more
- WCAG: 4.1.2 (Level A)
🔴 critical: Ensure an element's role supports its ARIA attributes
- Rule: aria-allowed-attr · Affects 1/14 stories · Learn more
- WCAG: 4.1.2 (Level A)
🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/14 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Grid - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/12 stories · Learn more
- WCAG: 1.4.3 (Level AA)

GridMasonry - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/3 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Heading - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/16 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Icon - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/17 stories · Learn more
- WCAG: 1.4.3 (Level AA)

InputGroup - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 9/16 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Item - 2 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/9 stories · Learn more
- WCAG: 1.4.3 (Level AA)
🔴 critical: Ensure an element's role supports its ARIA attributes
- Rule: aria-allowed-attr · Affects 1/9 stories · Learn more
- WCAG: 4.1.2 (Level A)

Kbd - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 6/8 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Layout - 2 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 14/18 stories · Learn more
- WCAG: 1.4.3 (Level AA)
🟡 moderate: Ensure landmarks are unique
- Rule: landmark-unique · Affects 1/18 stories · Learn more

List - 2 issue(s)

🔴 critical: Ensure an element's role supports its ARIA attributes
- Rule: aria-allowed-attr · Affects 1/12 stories · Learn more
- WCAG: 4.1.2 (Level A)
🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/12 stories · Learn more
- WCAG: 1.4.3 (Level AA)

LogStream - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/3 stories · Learn more
- WCAG: 1.4.3 (Level AA)

OverflowList - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/8 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Overlay - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/10 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Pagination - 1 issue(s)

🟡 moderate: Ensure landmarks are unique
- Rule: landmark-unique · Affects 1/14 stories · Learn more

PowerSearch - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/24 stories · Learn more
- WCAG: 1.4.3 (Level AA)

ProgressBar - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/13 stories · Learn more
- WCAG: 1.4.3 (Level AA)

RadioList - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 3/12 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Schedule - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 4/7 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Section - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/7 stories · Learn more
- WCAG: 1.4.3 (Level AA)

SegmentedControl - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 4/7 stories · Learn more
- WCAG: 1.4.3 (Level AA)

SelectableCard - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/4 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Stack - 1 issue(s)

🟠 serious: Ensure elements that have scrollable content are accessible by keyboard in Safari
- Rule: scrollable-region-focusable · Affects 1/16 stories · Learn more
- WCAG: 2.1.1, 2.1.3 (Level A)

Stepper - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/16 stories · Learn more
- WCAG: 1.4.3 (Level AA)

TabList - 1 issue(s)

🟡 moderate: Ensure landmarks are unique
- Rule: landmark-unique · Affects 2/11 stories · Learn more

Table - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 4/24 stories · Learn more
- WCAG: 1.4.3 (Level AA)

TableGroupedRows - 2 issue(s)

🟠 serious: Ensure ARIA attributes are used as described in the specification of the element's role
- Rule: aria-conditional-attr · Affects 3/3 stories · Learn more
- WCAG: 4.1.2 (Level A)
🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/3 stories · Learn more
- WCAG: 1.4.3 (Level AA)

TablePagination - 1 issue(s)

🟡 moderate: Ensure landmarks are unique
- Rule: landmark-unique · Affects 2/9 stories · Learn more

TableTree - 1 issue(s)

🟠 serious: Ensure ARIA attributes are used as described in the specification of the element's role
- Rule: aria-conditional-attr · Affects 6/7 stories · Learn more
- WCAG: 4.1.2 (Level A)

Text - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/23 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Theme - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/5 stories · Learn more
- WCAG: 1.4.3 (Level AA)

PopArt - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 3/6 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Thumbnail - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/11 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Timestamp - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 1/13 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Token - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/10 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Tokenizer - 1 issue(s)

🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
- Rule: color-contrast · Affects 2/20 stories · Learn more
- WCAG: 1.4.3 (Level AA)

Toolbar - 1 issue(s)

🟡 moderate: Ensure landmarks are unique
- Rule: landmark-unique · Affects 1/13 stories · Learn more

ToolbarEdgeCompensation - 1 issue(s)

🟡 moderate: Ensure landmarks are unique
- Rule: landmark-unique · Affects 1/23 stories · Learn more

_{Generated by PR Enrichment workflow | Storybook | Sandbox | View full report}

…forcement layer 1) When @astryxdesign/core is installed and the project hasn't run init yet, print a one-line next-step so agents/humans discover it — the most common fresh-install entry. - scripts/postinstall.mjs is self-contained (core can't import the CLI), so the agent-doc locations + marker duplicate the CLI's discovery (agent-docs.mjs); the Hermes entries are an intentional superset. Never fails the install. - Quiet in the monorepo/source build, during npx's transient fetch, and once set up. - Message is the validated simple one-liner (message-format vibe test).

Seven published-behavior PRs merged since v0.1.7 without a changeset, which would leave their contributors uncredited in the CHANGELOG. Add changesets so the v0.1.8 bump credits them: - core docs.mjs redirect to the CLI (#4207) - Table tree-data plugin: useTableTreeState / useTableTreeData (#3789) - Table tree expander aria-label localization (#4149) - foolproof init: postinstall nudges + non-interactive init (#4147, #4153, #4154, #4155)

meta-cla Bot added the CLA Signed This label is managed by the Meta Open Source bot. label Jul 22, 2026

josephfarina force-pushed the navi/vibe/core-postinstall branch from 102b789 to 377f1e6 Compare July 22, 2026 00:49

vercel Bot deployed to Preview July 22, 2026 00:52 View deployment

github-actions Bot added a commit that referenced this pull request Jul 22, 2026

Deploy PR #4155 preview

584fb24

josephfarina mentioned this pull request Jul 22, 2026

astryx init foolproof: per-command setup nudge + centralized setup check #4153

Merged

josephfarina force-pushed the navi/vibe/core-postinstall branch from 377f1e6 to 965f662 Compare July 22, 2026 03:40

josephfarina marked this pull request as ready for review July 22, 2026 03:42

josephfarina requested review from cixzhang, ejhammond and imdreamrunner as code owners July 22, 2026 03:42

vercel Bot deployed to Preview July 22, 2026 03:42 View deployment

github-actions Bot added a commit that referenced this pull request Jul 22, 2026

Deploy PR #4155 preview

09694db

josephfarina force-pushed the navi/vibe/core-postinstall branch from 965f662 to 8a8331f Compare July 22, 2026 03:56

vercel Bot deployed to Preview July 22, 2026 03:58 View deployment

josephfarina enabled auto-merge (squash) July 22, 2026 04:00

github-actions Bot added a commit that referenced this pull request Jul 22, 2026

Deploy PR #4155 preview

34b605f

josephfarina merged commit 1ef4f07 into main Jul 22, 2026
19 checks passed

josephfarina mentioned this pull request Jul 22, 2026

astryx init foolproof: one dep-free source for the setup check (layers 1-3) #4162

Draft

github-actions Bot deleted the navi/vibe/core-postinstall branch July 22, 2026 06:56

cixzhang mentioned this pull request Jul 22, 2026

docs: add missing changesets for v0.1.8 attribution #4222

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

astryx init foolproof: @astryxdesign/core postinstall nudge#4155

astryx init foolproof: @astryxdesign/core postinstall nudge#4155
josephfarina merged 1 commit into
mainfrom
navi/vibe/core-postinstall

josephfarina commented Jul 22, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Jul 22, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 22, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

josephfarina commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What

Tests

Uh oh!

vercel Bot commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Analysis Report

📚 Storybook Preview

🧪 Sandbox Preview

Bundle Size Summary

Accessibility Audit

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

josephfarina commented Jul 22, 2026 •

edited

Loading

vercel Bot commented Jul 22, 2026 •

edited

Loading

github-actions Bot commented Jul 22, 2026 •

edited

Loading