- Ant Design of React
- v5.21.6Changelog
- Basic Usage
- Advanced
- Migration
- Other
Contributing
The following is a set of guidelines for contributing to Ant Design. Please spend several minutes reading these guidelines before you create an issue or pull request.
We have adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.
All work on Ant Design happens directly on GitHub. Both core team members and external contributors send pull requests which go through the same review process.
According to our release schedule, we maintain two branches, master
and feature
. If you send a bugfix pull request, please do it against the master
branch, if it's a feature pull request, please do it against the feature
branch.
We are using GitHub Issues for bug tracking. The best way to get your bug fixed is by using our issue helper and provide reproduction steps with this template.
Before you report a bug, please make sure you've searched existing issues, and read our FAQ.
If you intend to change the public API or introduce new feature, we also recommend you use our issue helper to create a feature request issue.
If you want to help on new API, please reference API Naming Rules to name it.
Working on your first Pull Request? You can learn how from this free video series:
How to Contribute to an Open Source Project on GitHub
To help you get your feet wet and get you familiar with our contribution process, we have a list of good first issues that contain bugs or small features that have a relatively limited scope. This is a great place to get started.
If you decide to fix an issue, please be 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 intend to work on it so other people don't accidentally duplicate your effort.
If somebody claims an issue but doesn't follow up for more than two weeks, it's fine to take over it but you should still leave a comment.
The core team is monitoring for pull requests. We will review your pull request and either merge it, request changes to it, or close it with an explanation.
Before submitting a pull request, please make sure the following is done:
npm install
in the repository root.npm test -- --watch TestName
is helpful in development.npm test -- -u
to update the jest snapshots and commit these changes as well (if there are any updates).npm run test:image
, Run npm run test:image -- -u
to update UI snapshots and commit these changes as well (if there are any updates), UI test base on Docker, need download the corresponding installation according to the platformgit commit
(Use Git Hooks).detail
to enter the details to view the reason.Sending a Pull Request to react-component:
Since antd's components are based on react-component, sometimes you may need to send pull request to the corresponding react-component repository. If it's a bugfix pull request, after it's merged, the core team will release a patch release for that component as soon as possible, then you only need to reinstall antd in your project to get the latest patch release. If it's a feature pull request, after it's merged, the core team will release a minor release, then you need raise another pull request to Ant Design to update dependencies, document and TypeScript interfaces (if needed).
npm
or yarn
are recommended as package management tools.
After you clone the antd code and use following commands to install dependencies:
$ npm install
You can also run the following common commands:
Runs Ant Design website locally.
$ npm start
$ npm run lint
runs the complete test suite. (Make sure the NODE_ENV
environment variable is unset, or it may causing some problems.)
$ npm test
compiles TypeScript code to the lib
and es
directory.
$ npm run compile
creates UMD build of antd.
$ npm run dist
If you are an active contributor and are willing to work with Ant Design Team in our opensource workflow, you can apply to be a outside collaborator.
You can also refer to the following contribution guide to become an antd contributor: