Contributing to Muuri-react

May 14, 2020 ยท View on GitHub

Thanks for the interest in contributing to Muuri-react! Here you will find some instructions on how to create an issue or a pull request.

Creating an issue

Muuri-react is based on the Muuri layout engine which is used internally. If your issue is related to the layout, sorting or any other feature of Muuri please open the issue in the Muuri repository.

Questions

You should check out the existing questions and see if your question has been asked/answered already. If not, you can create a new issue and explain the problem you're facing.

Improvements

Improvement ideas are always welcome! Please check first the existing ideas and enhancements so that you won't be creating a duplicate issue.

Bugs

Please create an issue and explain the bug in detail. If possible create a reduced test case and share a link to it. You can, for example, fork this Codesandbox example and modify it to demonstrate the bug.

Creating a pull request

  1. Discuss first.
    • The first step should always be creating a new issue and discussing your pull request suggestion with the authors and the community.
    • After you get green light it's time to get coding.
  2. Fork the repo and create a new branch for your pull request.
    • Fork Muuri-react.
    • Create a new branch for your pull request from the master branch. The name of the pull request branch should start with the id of the issue you opened for the pull request (e.g. #123-fix-something).
  3. Setup the development environment.
    • Run npm install in the repository's directory.
    • You can now run the following commands:
      • npm run build
        • Builds build/index.js from src directory.
      • npm run eslint
        • Lints all files in src, test and examples directories with ESLint.
      • npm run prettier
        • Formats all files in src, test and examples directories with Prettier.
      • npm run test
        • Runs unit tests for src.
  4. Do the updates in src folder.
    • Now is the time to make the actual updates to Muuri.
    • Remember scope. Don't refactor things that are not related to the pull request.
    • After you're done update tests and docs (README.md) if necessary.
  5. Format, build and test changes.
    • Run npm run format, npm run build and finally npm run test.
  6. Create the pull request.
    • Do your best to explain what the pull request fixes.
    • Mention which issue(s) will be closed by the pull request, e.g. Closes #123.
    • After your pull request is accepted it will be merged to the dev branch and released with the next release. If you did only some minor change in the documentation it may be merged directly to the master branch.
  7. You made it! Thank you so much for contributing to Muuri-react!