2026-03-11 12:22:49 +01:00
# Contributing to Material
2016-01-28 00:07:12 +00:00
2023-10-12 14:31:21 -05:00
If you're reading this, you're awesome!
2024-01-20 21:36:51 +01:00
Thank you for being a part of the community and helping us make these projects great.
2023-10-12 14:31:21 -05:00
Here are a few guidelines that will help you along the way.
2016-01-28 00:07:12 +00:00
2023-05-11 07:44:20 +02:00
## Summary
2023-10-12 14:31:21 -05:00
- [Code of conduct ](#code-of-conduct )
2023-05-11 07:44:20 +02:00
- [A large spectrum of contributions ](#a-large-spectrum-of-contributions )
2023-10-12 14:31:21 -05:00
- [Your first pull request ](#your-first-pull-request )
- [Sending a pull request ](#sending-a-pull-request )
2023-05-11 07:44:20 +02:00
- [Trying changes on the documentation site ](#trying-changes-on-the-documentation-site )
- [Trying changes on the playground ](#trying-changes-on-the-playground )
2023-10-12 14:31:21 -05:00
- [How to increase the chances of being accepted ](#how-to-increase-the-chances-of-being-accepted )
2023-05-11 07:44:20 +02:00
- [CI checks and how to fix them ](#ci-checks-and-how-to-fix-them )
- [Updating the component API documentation ](#updating-the-component-api-documentation )
- [Coding style ](#coding-style )
2023-12-22 10:13:28 -06:00
- [Contributing to the documentation ](#contributing-to-the-documentation )
- [How to find docs issues to work on ](#how-to-find-docs-issues-to-work-on )
- [How to add a new demo to the docs ](#how-to-add-a-new-demo-to-the-docs )
2023-10-12 14:31:21 -05:00
- [How can I use a change that hasn't been released yet? ](#how-can-i-use-a-change-that-hasnt-been-released-yet )
2023-05-11 07:44:20 +02:00
- [Roadmap ](#roadmap )
- [License ](#license )
2023-10-12 14:31:21 -05:00
## Code of conduct
2016-01-27 21:45:25 +00:00
2024-03-26 21:36:59 +01:00
We have adopted the [Contributor Covenant ](https://www.contributor-covenant.org/ ) as our code of conduct, and we expect project participants to adhere to it.
2022-12-05 19:17:46 +05:30
Please read [the full text ](https://github.com/mui/.github/blob/master/CODE_OF_CONDUCT.md ) to understand what actions will and will not be tolerated.
2016-01-27 21:45:25 +00:00
2019-10-01 10:17:47 +02:00
## A large spectrum of contributions
2016-01-27 21:45:25 +00:00
2024-01-20 21:36:51 +01:00
There are [many ways ](https://mui.com/material-ui/getting-started/faq/#mui-is-awesome-how-can-i-support-the-project ) to contribute to the library, and writing code is only one part of the story—[documentation improvements ](#contributing-to-the-documentation ) can be just as important as code changes.
2023-10-12 14:31:21 -05:00
If you have an idea for an improvement to the code or the docs, we encourage you to open an issue as a first step, to discuss your proposed changes with the maintainers before proceeding.
2016-01-27 21:45:25 +00:00
2023-10-12 14:31:21 -05:00
## Your first pull request
2016-04-27 20:55:07 -04:00
2023-10-12 14:31:21 -05:00
Working on your first pull request? You can learn how in this free video series: [How to Contribute to an Open Source Project on GitHub ](https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github ).
2018-03-16 20:17:16 +00:00
2023-10-12 14:31:21 -05:00
Get started with [good first issues ](https://github.com/mui/material-ui/issues?q=is:open+is:issue+label:"good+first+issue" ), which have a limited scope and a working solution that's already been discussed.
This makes them ideal for newer developers, or those who are new to these libraries and want to see how the contribution process works.
2016-01-27 21:45:25 +00:00
2024-02-02 14:07:58 +03:00
We also have a list of [ready to take issues ](https://github.com/mui/material-ui/issues?q=is:open+is:issue+label:"ready+to+take" ), which are issues that have already been at least partially resolved in discussion, to the point that it's clear what to do next.
2023-10-12 14:31:21 -05:00
These issues are great for developers who want to reduce their chances of falling down a rabbit hole in search of a solution.
2020-06-05 11:04:46 -03:00
2024-02-02 14:07:58 +03:00
Of course, you can work on any other issue you like—the "good first" and "ready to take" issues are simply those where the scope and timeline may be better defined.
2023-10-12 14:31:21 -05:00
Pull requests for other issues, or completely novel problems, may take a bit longer to review if they don't fit into our current development cycle.
2016-05-21 20:19:33 -04:00
2023-10-12 14:31:21 -05:00
If you decide to fix an issue, please make sure to check the comment thread in case somebody is already working on a fix.
If nobody is working on it at the moment, please leave a comment stating that you've started to work on it, so other people don't accidentally duplicate your effort.
2021-06-28 10:37:04 +02:00
2023-10-12 14:31:21 -05:00
If somebody claims an issue but doesn't follow up after more than a week, it's fine to take over, but you should still leave a comment.
If there has been no activity on the issue for 7 to 14 days, then it's safe to assume that nobody is working on it.
2018-10-17 20:15:56 +02:00
2023-10-12 14:31:21 -05:00
## Sending a pull request
2018-10-17 20:15:56 +02:00
2024-01-20 21:36:51 +01:00
MUI
2016-05-21 20:19:33 -04:00
2023-10-12 14:31:21 -05:00
When in doubt, keep your pull requests small.
For the best chances of being accepted, don't bundle more than one feature or bug fix per PR.
It's often best to create two smaller PRs rather than one big one.
2016-01-27 21:45:25 +00:00
2019-10-01 10:17:47 +02:00
1. Fork the repository.
2023-10-12 14:31:21 -05:00
2. Clone the fork to your local machine and add the upstream remote:
2016-01-27 21:45:25 +00:00
2023-07-04 14:01:00 +02:00
``` bash
2020-05-24 23:11:06 +02:00
git clone https://github.com/<your username>/material-ui.git
2019-10-01 10:17:47 +02:00
cd material-ui
2022-02-06 16:32:18 +01:00
git remote add upstream https://github.com/mui/material-ui.git
2019-10-01 10:17:47 +02:00
```
2025-02-04 09:46:53 -03:00
<!-- #target -branch-reference -->
2021-09-14 11:08:42 +02:00
2024-08-27 14:15:20 +07:00
3. Synchronize your local `master` branch with the upstream one:
2019-10-01 10:17:47 +02:00
2023-07-04 14:01:00 +02:00
``` bash
2024-08-27 14:15:20 +07:00
git checkout master
git pull upstream master
2019-10-01 10:17:47 +02:00
```
2024-01-03 22:00:41 +01:00
4. Install the dependencies with pnpm (yarn or npm aren't supported):
2019-10-01 10:17:47 +02:00
2023-07-04 14:01:00 +02:00
``` bash
2024-01-03 22:00:41 +01:00
pnpm install
2016-01-27 21:45:25 +00:00
```
2019-12-24 23:28:07 +05:30
5. Create a new topic branch:
2023-07-04 14:01:00 +02:00
``` bash
2019-12-24 23:28:07 +05:30
git checkout -b my-topic-branch
2020-01-15 21:46:11 +05:30
```
2019-12-24 23:28:07 +05:30
2023-10-12 14:31:21 -05:00
6. Make changes, commit, and push to your fork:
2019-10-01 10:17:47 +02:00
2023-07-04 14:01:00 +02:00
``` bash
2020-05-26 21:32:23 +01:00
git push -u origin HEAD
2019-10-01 10:17:47 +02:00
```
2023-10-12 14:31:21 -05:00
7. Go to [the repository ](https://github.com/mui/material-ui ) and open a pull request.
2019-10-01 10:17:47 +02:00
2023-10-12 14:31:21 -05:00
The core team actively monitors for new pull requests.
We will review your PR and either merge it, request changes to it, or close it with an explanation.
2019-10-01 10:17:47 +02:00
2020-12-01 22:56:30 +01:00
### Trying changes on the documentation site
2024-01-20 21:36:51 +01:00
The documentation site is built with Material
2023-10-12 14:31:21 -05:00
This is the best place to experiment with your changes—it's the local development environment used by the maintainers.
2020-12-01 22:56:30 +01:00
2023-10-12 14:31:21 -05:00
To get started, run:
2020-12-01 22:56:30 +01:00
2023-07-04 14:01:00 +02:00
``` bash
2024-01-03 22:00:41 +01:00
pnpm start
2020-12-01 22:56:30 +01:00
```
2022-10-14 23:43:53 +02:00
You can now access the documentation site locally: http://localhost:3000.
2020-12-01 22:56:30 +01:00
Changes to the docs will hot reload the site.
2022-10-14 23:43:53 +02:00
### Trying changes on the playground
2023-10-12 14:31:21 -05:00
While we do recommend trying your changes on the documentation site, this is not always ideal.
2022-12-05 19:17:46 +05:30
You might face the following problems:
2022-10-14 23:43:53 +02:00
2023-10-12 14:31:21 -05:00
- Updating the existing demos prevents you from working in isolation on a single instance of the component
- Emptying an existing page to try your changes in isolation leads to a noisy `git diff`
- Static linters may report issues that you might not care about
2022-10-14 23:43:53 +02:00
2023-10-12 14:31:21 -05:00
To avoid these problems, you can use this playground:
2022-10-14 23:43:53 +02:00
2023-07-04 14:01:00 +02:00
``` bash
2024-01-03 22:00:41 +01:00
pnpm docs:create-playground && pnpm start
2022-10-14 23:43:53 +02:00
```
2023-10-12 14:31:21 -05:00
Access it locally at: http://localhost:3000/playground/.
2022-10-14 23:43:53 +02:00
2023-10-12 14:31:21 -05:00
You can create as many playgrounds as you want by going to the `/docs/pages/playground/` folder and duplicating the `index.tsx` file with a different name: `<file_name>.tsx` .
The new playground will be accessible at: `http://localhost:3000/playground/<file_name>` .
2022-10-14 23:43:53 +02:00
2023-10-12 14:31:21 -05:00
### How to increase the chances of being accepted
2019-10-01 10:17:47 +02:00
2023-10-12 14:31:21 -05:00
Continuous Integration (CI) automatically runs a series of checks when a PR is opened.
If you're unsure whether your changes will pass, you can always open a PR, and the GitHub UI will display a summary of the results.
2025-02-04 16:59:22 +01:00
If any of these checks fail, refer to [CI checks and how to fix them ](#ci-checks-and-how-to-fix-them ).
2019-10-27 14:52:10 +01:00
2019-10-01 10:17:47 +02:00
Make sure the following is true:
2025-02-04 09:46:53 -03:00
<!-- #target -branch-reference -->
2021-09-20 09:04:44 +02:00
2024-08-27 14:15:20 +07:00
- The branch is targeted at `master` for ongoing development. All tests are passing. Code that lands in `master` must be compatible with the latest stable release. It may contain additional features but no breaking changes. We should be able to release a new minor version from the tip of `master` at any time.
2019-10-01 10:17:47 +02:00
- If a feature is being added:
2023-10-12 14:31:21 -05:00
- If the result was already achievable with the core library, you've explained why this feature needs to be added to the core.
- If this is a common use case, you've added an example to the documentation.
- If adding new features or modifying existing ones, you've included tests to confirm the new behavior. You can read more about our test setup in our test [README ](https://github.com/mui/material-ui/blob/HEAD/test/README.md ).
- If props were added or prop types were changed, you've updated the TypeScript declarations.
- If submitting a new component, you've added it to the [lab ](https://github.com/mui/material-ui/tree/HEAD/packages/mui-lab ).
2025-02-04 16:59:22 +01:00
- The branch is not [behind its target branch ](https://docs.github.com/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/keeping-your-pull-request-in-sync-with-the-base-branch ).
2019-10-01 10:17:47 +02:00
2023-10-12 14:31:21 -05:00
We will only merge a PR when all tests pass.
The following statements must be true:
2021-01-07 14:17:55 -03:00
2024-01-03 22:00:41 +01:00
- The code is formatted. If the code was changed, run `pnpm prettier` .
- The code is linted. If the code was changed, run `pnpm eslint` .
- The code is type-safe. If TypeScript sources or declarations were changed, run `pnpm typescript` to confirm that the check passes.
- The API docs are up to date. If API was changed, run `pnpm proptypes && pnpm docs:api` .
2024-06-26 22:23:19 +02:00
- The demos are up to date. If demos were changed, run `pnpm docs:typescript:formatted` . See [about writing demos ](#2-write-the-demo-code ).
2023-10-12 14:31:21 -05:00
- The pull request title follows the pattern `[product-name][Component] Imperative commit message` . (See: [How to Write a Git Commit Message ](https://chris.beams.io/posts/git-commit/ ) for a great explanation).
2021-01-07 14:17:55 -03:00
2023-10-12 14:31:21 -05:00
Don't worry if you miss a step—the Continuous Integration will run a thorough set of tests on your commits, and the maintainers of the project can assist you if you run into problems.
2019-10-01 10:17:47 +02:00
2022-04-12 17:40:53 -03:00
If your pull request addresses an open issue, make sure to link the PR to that issue.
Use any [supported GitHub keyword ](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword ) in the PR description to automatically link them.
2023-10-12 14:31:21 -05:00
This makes it easier to understand where the PR is coming from, and also speeds things up because the issue will be closed automatically when the PR is merged.
2022-04-12 17:40:53 -03:00
2023-05-11 07:44:20 +02:00
### CI checks and how to fix them
2019-10-27 14:52:10 +01:00
2023-10-12 14:31:21 -05:00
If any of the checks fail, click on the **Details ** link and review the logs of the build to find out why it failed.
For CircleCI, you need to log in first.
2021-06-28 10:37:04 +02:00
No further permissions are required to view the build logs.
2023-10-12 14:31:21 -05:00
The following sections give an overview of what each check is responsible for.
2019-10-27 14:52:10 +01:00
2025-08-25 15:52:08 +02:00
#### Continuous Releases
2019-10-27 14:52:10 +01:00
2025-08-25 15:52:08 +02:00
This task publishes a preview for the packages to pkg.pr.new. It should not fail in isolation. Use it to test more complex scenarios.
2019-10-27 14:52:10 +01:00
2023-05-11 07:44:20 +02:00
#### ci/circleci: checkout
2019-10-27 14:52:10 +01:00
2023-10-12 14:31:21 -05:00
This is a preflight check to see if the dependencies and lockfile are ok.
2024-01-03 22:00:41 +01:00
Running `pnpm` and `pnpm deduplicate` should fix most issues.
2019-10-27 14:52:10 +01:00
2023-05-11 07:44:20 +02:00
#### ci/circleci: test_static
2019-10-27 14:52:10 +01:00
2023-10-12 14:31:21 -05:00
This checks code format and lints the repository.
The log of the failed build should explain how to fix any issues.
2024-01-03 22:00:41 +01:00
It also runs commands that generate or change some files (like `pnpm docs:api` for API documentation).
2023-10-12 14:31:21 -05:00
If the CI job fails, then you most likely need to run the commands that failed locally and commit the changes.
2019-10-27 14:52:10 +01:00
2023-05-11 07:44:20 +02:00
#### ci/circleci: test_unit-1
2019-10-27 14:52:10 +01:00
2023-10-12 14:31:21 -05:00
This runs the unit tests in a `jsdom` environment.
2024-01-03 22:00:41 +01:00
If it fails then `pnpm test:unit` should<sup>[1 ](test/README.md#accessibility-tree-exclusion )</sup> fail locally as well.
You can narrow the scope of tests run with `pnpm test:unit --grep ComponentName` .
If `pnpm test:unit` passes locally, but fails in CI, consider [Accessibility tree exclusion in CI ](test/README.md#accessibility-tree-exclusion ).
2019-10-27 14:52:10 +01:00
2025-12-01 16:46:35 +01:00
#### ci/circleci: test_browser
2019-10-27 14:52:10 +01:00
2025-12-01 16:46:35 +01:00
This runs the unit tests in multiple browsers (via Playwright).
2023-10-12 14:31:21 -05:00
The log of the failed build should list which browsers failed.
2025-12-01 16:46:35 +01:00
If Chrome failed then `pnpm test:browser` should<sup>[1 ](test/README.md#accessibility-tree-exclusion )</sup> fail locally as well.
If other browsers failed, you can debug using `VITEST_BROWSERS=firefox,webkit pnpm test:browser` .
2019-10-27 14:52:10 +01:00
2025-12-01 16:46:35 +01:00
#### ci/circleci: test_regression
2019-10-27 14:52:10 +01:00
2023-10-12 14:31:21 -05:00
This renders tests in `test/regressions/tests` and takes screenshots.
This step shouldn't fail if the others pass.
Otherwise, a maintainer will take a look.
The screenshots are evaluated in another step.
2019-10-27 14:52:10 +01:00
2023-05-11 07:44:20 +02:00
#### ci/circleci: test_types
2021-02-19 18:45:19 +01:00
2023-10-12 14:31:21 -05:00
This typechecks the repository.
The log of the failed build should list any issues.
2021-02-19 18:45:19 +01:00
2023-05-11 07:44:20 +02:00
#### ci/circleci: test_bundle_size_monitor
2021-11-24 20:43:48 +00:00
2023-10-12 14:31:21 -05:00
This task is primarily responsible for monitoring the bundle size.
It will only report the size if the change exceeds a certain threshold.
If it fails, then there's usually something wrong with the way the packages or docs were built.
2021-11-24 20:43:48 +00:00
2023-05-11 07:44:20 +02:00
#### argos
2019-10-27 14:52:10 +01:00
2023-10-12 14:31:21 -05:00
This evaluates the screenshots taken in `test/regressions/tests` , and fails if it detects
differences.
This doesn't necessarily mean that your PR will be rejected, as a failure might be intended.
Clicking on **Details ** will show you the differences.
2019-10-27 14:52:10 +01:00
2023-05-11 07:44:20 +02:00
#### deploy/netlify
2019-10-27 14:52:10 +01:00
2023-10-12 14:31:21 -05:00
This renders a preview of the docs with your changes if it succeeds.
2024-02-09 17:17:38 +01:00
Otherwise `pnpm docs:build` usually fails locally as well.
2019-10-27 14:52:10 +01:00
#### codecov/project
2023-10-12 14:31:21 -05:00
This monitors coverage of the tests.
A reduction in coverage isn't necessarily bad, but it's always appreciated if it can be improved.
2019-10-27 14:52:10 +01:00
#### Misc
2023-10-12 14:31:21 -05:00
There are various other checks done by Netlify to validate the integrity of the docs.
Click on **Details ** to find out more about them.
2019-10-27 14:52:10 +01:00
2018-07-27 13:08:51 +03:00
### Updating the component API documentation
2021-07-08 02:26:40 +02:00
The component API in the component `propTypes` and under `docs/pages/api-docs` is auto-generated from the [JSDoc ](https://jsdoc.app/about-getting-started.html ) in the TypeScript declarations.
2024-03-16 23:58:53 +01:00
Be sure to update the documentation in the corresponding `.d.ts` files (for example `packages/mui-material/src/Button/Button.d.ts` for `<Button>` ) and then run:
2019-10-27 14:52:10 +01:00
2023-07-04 14:01:00 +02:00
``` bash
2024-01-03 22:00:41 +01:00
$ pnpm proptypes
$ pnpm docs:api
2018-07-27 13:08:51 +03:00
```
2016-05-21 20:19:33 -04:00
### Coding style
2016-01-27 21:45:25 +00:00
2023-10-12 14:31:21 -05:00
Please follow the coding style of the project.
2024-08-25 13:41:38 +02:00
It uses Prettier and ESLint, so if possible, enable linting in your editor to get real-time feedback.
2017-08-30 10:56:41 +02:00
2024-01-03 22:00:41 +01:00
- `pnpm prettier` reformats the code.
- `pnpm eslint` runs the linting rules.
2016-01-27 21:45:25 +00:00
2023-10-12 14:31:21 -05:00
When you submit a PR, these checks are run again by our continuous integration tools, but hopefully your code is already clean!
2017-11-03 03:48:15 +08:00
2023-12-22 10:13:28 -06:00
## Contributing to the documentation
Contributing to open-source docs involves a lot more than just fixing typos—developers frequently request more in-depth explanations of component features, and this requires both coding and technical writing to accomplish.
Every documentation PR will be reviewed by an editor following [MUI's writing style guide ](https://mui-org.notion.site/Writing-style-guide-2a957a4168a54d47b14bae026d06a24b ), and if you plan to contribute regularly, you should familiarize yourself with this guide to speed up the editing process.
### How to find docs issues to work on
If you're interested in contributing to the docs but aren't sure where to start, you can use this search prompt in the GitHub repo to find open issues tagged with both `docs` and `ready to take` :
`is:issue is:open label:docs label:"ready to take"`
Or [follow this link directly to the results of that search ](https://github.com/mui/material-ui/issues?q=is%3Aissue+is%3Aopen+label%3Adocs+label%3A%22ready+to+take%22 ).
### How to add a new demo to the docs
2017-11-03 03:48:15 +08:00
2023-10-12 14:31:21 -05:00
The following steps explain how to add a new demo to the docs using the Button component as an example:
2017-11-03 03:48:15 +08:00
2023-12-22 10:13:28 -06:00
#### 1. Add a new component file to the directory
2017-11-03 03:48:15 +08:00
2025-12-27 14:13:07 +01:00
Add the new file to the component's corresponding directory:
2019-10-01 10:17:47 +02:00
2023-07-04 14:01:00 +02:00
``` bash
2019-05-08 17:37:34 +01:00
docs/src/pages/components/buttons/
2017-11-03 03:48:15 +08:00
```
2019-01-31 16:26:21 +01:00
2025-12-27 14:13:07 +01:00
and give it a name: how about `SuperButtons.tsx` ?
2023-10-12 14:31:21 -05:00
2023-12-22 10:13:28 -06:00
#### 2. Write the demo code
2023-10-12 14:31:21 -05:00
2024-10-24 21:11:12 +05:30
We use TypeScript to document our components.
2024-03-16 23:58:53 +01:00
We prefer demos written in TypeScript (using the `.tsx` file format).
2023-10-12 14:31:21 -05:00
2024-01-03 22:00:41 +01:00
After creating a TypeScript demo, run `pnpm docs:typescript:formatted` to automatically create the JavaScript version, which is also required.
2019-01-31 16:26:21 +01:00
2024-03-16 23:58:53 +01:00
If you're not familiar with TypeScript, you can write the demo in JavaScript, and a core contributor may help you migrate it to TypeScript.
2017-11-03 03:48:15 +08:00
2023-12-22 10:13:28 -06:00
#### 3. Edit the page's Markdown file
2017-11-03 03:48:15 +08:00
2023-10-12 14:31:21 -05:00
The Markdown file in the component's respective folder—in this case, `/buttons/buttons.md` —is the source of content for the document.
Any changes you make there will be reflected on the website.
Add a header and a brief description of the demo and its use case, along with the `"demo"` code snippet to inject it into the page:
2019-02-19 09:31:18 +01:00
2017-11-03 03:48:15 +08:00
``` diff
2019-10-01 10:17:47 +02:00
+### Super buttons
2017-11-03 03:48:15 +08:00
+
2023-10-12 14:31:21 -05:00
+To create a super button for a specific use case, add the `super` prop:
2017-11-03 03:48:15 +08:00
+
2019-10-01 10:17:47 +02:00
+{{"demo": "pages/components/buttons/SuperButtons.js"}}
2017-11-03 03:48:15 +08:00
```
2023-12-22 10:13:28 -06:00
#### 4. Submit your PR
2019-01-31 16:26:21 +01:00
2023-10-12 14:31:21 -05:00
Now you're ready to [open a PR ](#sending-a-pull-request ) to add your new demo to the docs.
2019-01-31 16:26:21 +01:00
2023-10-12 14:31:21 -05:00
Check out [this Toggle Button demo PR ](https://github.com/mui/material-ui/pull/19582/files ) for an example of what your new and edited files should look like when opening your own demo PR.
2019-01-31 16:26:21 +01:00
2023-10-12 14:31:21 -05:00
## How can I use a change that hasn't been released yet?
2020-12-02 11:39:18 +01:00
2025-08-25 15:52:08 +02:00
We use [pkg.pr.new ](https://pkg.pr.new ) to publish a working version of the packages for each pull request as a "preview."
2020-12-02 11:39:18 +01:00
2025-08-25 15:52:08 +02:00
You can check the _ Continuous Releases _ status of a pull request to get the URL needed to install these preview packages:
2020-12-02 11:39:18 +01:00
``` diff
diff --git a//package.json b//package.json
index 791a7da1f4..a5db13b414 100644
--- a/package.json
+++ b/package.json
@@ -61,7 +61,7 @@
"dependencies": {
"@babel/runtime": "^7.4.4",
2021-09-01 10:27:09 +02:00
"@mui/styled-engine": "^5.0.0-alpha.16",
- "@mui/material": "^5.0.0-alpha.15",
2025-08-25 15:52:08 +02:00
+ "@mui/material": "https://pkg.pr.new/mui/material-ui/@mui/material@b0f26aa",
2021-09-01 10:27:09 +02:00
"@mui/system": "^5.0.0-alpha.16",
2020-12-02 11:39:18 +01:00
```
2025-08-25 15:52:08 +02:00
Alternatively, you can open the Netlify preview of the documentation, and open any demo in CodeSandbox or StackBlitz.
2023-10-12 14:31:21 -05:00
The documentation automatically configures the dependencies to use the preview packages.
2020-12-02 11:39:18 +01:00
2022-06-10 13:01:34 +05:00
You can also package and test your changes locally.
2024-01-20 21:36:51 +01:00
The following example shows how to package `@mui/material` , but you can package any npm package with this process:
2022-06-10 13:01:34 +05:00
2023-07-04 14:01:00 +02:00
``` bash
2022-06-10 13:01:34 +05:00
$> cd packages/mui-material # or path to any other mui package
2024-01-03 22:00:41 +01:00
$packages \m ui-material> pnpm build
2022-06-10 13:01:34 +05:00
$packages \m ui-material> cd ./build
2024-01-03 22:00:41 +01:00
$packages \m ui-material> pnpm pack
2022-06-10 13:01:34 +05:00
```
Navigate to the build folder of your respective package and locate a file with the format `mui-material-x.x.x.tar.gz` .
Copy this file and move it to the project directory you want to test in, then run:
2023-07-04 14:01:00 +02:00
``` bash
2022-06-10 13:01:34 +05:00
$test -project> npm i ./path-to-file/mui-material-x.x.x.tar.gz
```
2023-03-10 15:59:15 +00:00
> **Note**
>
2023-10-12 14:31:21 -05:00
> If you've already installed this package, your changes will not be reflected when you reinstall it.
2024-01-03 22:00:41 +01:00
> As a quick fix, you can temporarily bump the version number in your `package.json` before running `pnpm build`.
2022-06-10 13:01:34 +05:00
2016-05-21 20:19:33 -04:00
## Roadmap
2016-01-28 00:07:12 +00:00
2024-01-20 21:36:51 +01:00
Learn more about the future by visiting our different projects' roadmaps:
- [Material ](https://mui.com/material-ui/discover-more/roadmap/ ).
2016-01-28 00:07:12 +00:00
2016-05-21 20:19:33 -04:00
## License
2016-01-27 21:45:25 +00:00
2022-02-06 16:32:18 +01:00
By contributing your code to the [mui/material-ui ](https://github.com/mui/material-ui ) GitHub repository, you agree to license your contribution under the [MIT license ](/LICENSE ).
