# components.build

An open-source standard for building modern, composable, and accessible UI components.

## About

components.build is a formal specification that establishes best practices and guidelines for building open-source UI components for the modern web. Co-authored by [Hayden Bleasel](https://x.com/haydenbleasel) and [shadcn](https://x.com/shadcn), this specification aims to help open-source maintainers and senior front-end engineers create components that are:

- **Composable** - Built with composition over inheritance, easily combined to create complex UIs
- **Accessible** - WCAG-compliant with proper ARIA attributes and keyboard navigation
- **Customizable** - Easy to theme and style for any design system
- **Performant** - Lightweight with minimal dependencies
- **Transparent** - Full code visibility and ownership
- **Well-documented** - Clear examples and developer-friendly

While examples use React/TypeScript, the core principles are framework-agnostic and applicable to Vue, Svelte, Angular, and other modern frameworks.

## Contributing

Contributions are welcome! This specification is informed by the open-source community and real-world component libraries.

To contribute, please read the [contributing guide](.github/CONTRIBUTING.md).

## License

This project is open source and available under the [MIT License](LICENSE).