Picker Recipes

💡 When you create a PR for any of the checklist items, add a link to this Epic under the PR's Related Issues section.

Preparation

• Open UI Research
  • [link to https://open-ui.org/]
• Open GitHub issues related to component
  • [link to each issue]
• Create react-* package and component from template
  • [link to package: https://github.com/microsoft/fluentui/tree/master/packages/react-components/react-(your-component)]
• (Optional) Draft implementation
  • [link to draft implementation, if applicable]
• Component Spec authored and reviewed

Implementation

• Component implementation
• Initial conformance and unit tests (validate basic functionality)
• Initial documentation
  • Storybook stories
  • README.md covering basic usage
  • MIGRATION.md guide (include v8 and v0)
• Component released as unstable from @fluentui/react-components/unstable

Validation

• Add tests
  • Unit and conformance tests
  • VR tests
  • Bundle size fixtures
  • Performance test scenario
  • Accessibility behavior tests
  • Create an issue and run manual accessibility tests: [link to issue]
• Validate with partners
• Run a bug bash with other FUI crews
• Finalize documentation
  • Review and add any missing storybook stories
  • Finalize migration guide
• Component released as stable from @fluentui/react-components
  • Ensure exports are removed from from @fluentui/react-components/unstable
  • In package.json: Remove the alpha/beta tag from the version number in package.json
  • In package.json: Change beachball's disallowedChangeTypes to "major", "prerelease"

Start with the linked Component Implementation Guide and the Open UI Research step, then review the react-(your-component) package template. The checklist spans implementation, conformance and unit tests, Storybook stories, README.md, MIGRATION.md, validation, and package.json release changes. Done means every preparation, implementation, validation, and release checkbox is addressed.