# @mui/joy
> Joy UI is an open-source React component library that implements MUI's own design principles. It's comprehensive and can be used in production out of the box.
Latest version **5.0.0-beta.52** (published 2025-03-18) · MIT license · 0 weekly downloads
## Install
```sh
npm install @mui/joy
pnpm add @mui/joy
yarn add @mui/joy
bun add @mui/joy
```
## Health
**Score 60/100 (C)** — status: stable.
Positive: has types; esm support; no vulnerabilities; high maintenance score; popular repo; extremely popular.
Warnings: low downloads.
Negative: stale.
## Facts
| | |
|---|---|
| Version | 5.0.0-beta.52 |
| Published | 2025-03-18 |
| First published | 2021-11-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=12.0.0 |
| Dependencies | 8 |
| Unpacked size | 4.2 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 99058 |
| Author | MUI Team |
| Maintainers | mbrookes, diegoandai, brijeshb42, michaldudak, mnajdova, siriwatknp, mj12albert, aarongarciah, atomiks, mui-release-bot, oliviertassinari |
| Keywords | react, react-component, design-system |
## Links
- npm: https://www.npmjs.com/package/@mui/joy
- Repository: https://github.com/mui/material-ui
- Homepage: https://v5.mui.com/joy-ui/getting-started/
- Issues: https://github.com/mui/material-ui/issues
- Funding: https://opencollective.com/mui-org
- npm.io page: https://npm.io/package/@mui/joy
## Dependencies (8)
- [clsx](https://npm.io/package/clsx.md) ^2.1.0
- [@mui/base](https://npm.io/package/@mui/base.md) 5.0.0-beta.40-1
- [@mui/types](https://npm.io/package/@mui/types.md) ~7.2.15
- [@mui/utils](https://npm.io/package/@mui/utils.md) ^5.17.1
- [prop-types](https://npm.io/package/prop-types.md) ^15.8.1
- [@mui/system](https://npm.io/package/@mui/system.md) ^5.17.1
- [@babel/runtime](https://npm.io/package/@babel/runtime.md) ^7.23.9
- [@mui/core-downloads-tracker](https://npm.io/package/@mui/core-downloads-tracker.md) ^5.17.1
## Alternatives
- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads
## Recent versions
- 5.0.0-beta.52 (latest) — 2025-03-18
- 5.0.0-beta.46 (next) — 2024-06-27
- 5.0.0-dev.20240529-082515-213b5e33ab (canary) — 2024-05-29
- 5.0.0-beta.51 — 2024-12-17
- 5.0.0-beta.50 — 2024-12-11
- 5.0.0-beta.49 — 2024-12-11
- 5.0.0-beta.48 — 2024-07-11
- 5.0.0-beta.47 — 2024-07-05
- 5.0.0-beta.45 — 2024-06-24
- 5.0.0-beta.44 — 2024-06-12
- 5.0.0-beta.43 — 2024-06-04
- 5.0.0-beta.42 — 2024-05-29
- 5.0.0-beta.41 — 2024-05-21
- 5.0.0-beta.40 — 2024-05-16
- 5.0.0-beta.39 — 2024-05-08
- … 130 more at https://npm.io/package/@mui/joy/versions
## README
Joy UI
Joy UI is an open-source React component library that implements MUI's own design principles. It's comprehensive and can be used in production out of the box.
## Installation
Install the package in your project directory with:
```bash
npm install @mui/joy @emotion/react @emotion/styled
```
## Documentation
Visit [https://v5.mui.com/joy-ui/getting-started/](https://v5.mui.com/joy-ui/getting-started/) to view the full documentation.
## Questions
For how-to questions that don't involve making changes to the code base, please use [Stack Overflow](https://stackoverflow.com/questions/tagged/joy-ui) instead of GitHub issues.
Use the "joy-ui" tag on Stack Overflow to make it easier for the community to find your question.
## Examples
The documentation features [a collection of example projects using Joy UI](https://github.com/mui/material-ui/tree/master/examples).
## Contributing
Read the [contributing guide](/CONTRIBUTING.md) to learn about the development process, how to propose bug fixes and improvements, and how to build and test your changes.
Contributing to Joy UI is about more than just issues and pull requests!
There are many other ways to [support Joy UI](https://v5.mui.com/material-ui/getting-started/faq/#mui-is-awesome-how-can-i-support-the-project) beyond contributing to the code base.
## Changelog
The [changelog](https://github.com/mui/material-ui/releases) is regularly updated to reflect what's changed in each new release.
## Roadmap
Future plans and high-priority features and enhancements can be found in the [roadmap](https://v5.mui.com/material-ui/discover-more/roadmap/).
## License
This project is licensed under the terms of the
[MIT license](/LICENSE).
## Security
For details of supported versions and contact details for reporting security issues, please refer to the [security policy](https://github.com/mui/material-ui/security/policy).
---
_Source: https://npm.io/package/@mui/joy · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._