Release candidate checklist (parity and accessibility)
Use this checklist before tagging a release candidate (for example next prerelease) or a stable release when the train includes user-facing changes.
Parity
- Changelog:
.changesetentries are accurate; no accidental omission of breaking notes. - Docs: Docs site builds cleanly; new or changed components have up-to-date docs pages.
- Storybook:
build-storybooksucceeds; representative stories exist for new components or states. - Package output:
npm run build:rollupandnpm run check:typespass on a clean tree.
Accessibility sign-off
- Smoke keyboard pass: Primary interactive components in this release behave correctly with keyboard only.
- Labels: Form controls and custom widgets expose accessible names where applicable.
- Focus: Modals, dialogs, and popovers manage focus (trap + restore) per project patterns.
Quality gates
- CI green: Lint, tests, and coverage workflows are passing on the release branch.
- Visual regression: Chromatic (or agreed substitute) reviewed for unexpected diffs.
Communication
- Migration notes: Breaking changes include actionable upgrade steps in the changelog / release notes.
- Known issues: Any deferred bugs are documented in the release notes or linked issues.