Skip to content

Latest commit

 

History

History
49 lines (36 loc) · 2.91 KB

CONTRIBUTING.md

File metadata and controls

49 lines (36 loc) · 2.91 KB

Contributing to REACT COOL DIMENSIONS

When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.

Please note we have a code of conduct, please follow it in all your interactions with the project.

Working on your first Pull Request? You can learn how from this free video series.

Pull Request Process

  1. Fork the repository and create your branch from master.
  2. Run yarn to install dependencies.
  3. If you’ve fixed a bug or added code that should be tested.
  4. Ensure the test suite passes by running yarn test.
  5. Update the README.md with details of changes to the interface.
  6. Update the demo app if needed.
  7. Make sure your code lints by running yarn lint.

Development Workflow

After cloning REACT COOL DIMENSIONS, run yarn to fetch its dependencies. Then, you can run several commands:

  • yarn dev runs the demo app as your playground at localhost:10001. Support live reloading.
  • yarn lint:code lints all .js and .tsx? files.
  • yarn lint:type runs the TypeScript type-checks.
  • yarn lint:style lints all .css and .tsx? (for Emotion) files.
  • yarn lint:format formats all files except the file list of .prettierignore.
  • yarn lint lints code, type, style, and format.
  • yarn test runs the complete test suite.
  • yarn test:watch runs an interactive test watcher (helpful in development).
  • yarn test:cov runs the complete test suite with coverage report.
  • yarn build:demo creates a public folder with all the static files.
  • yarn build:dist creates a dist folder with package builds (CJS & ESM) and type definition file. You can test the package locally via yarn link.
  • yarn build creates both public and dist.
  • yarn clean:dev deletes the demo/.dev build folder.
  • yarn clean:demo deletes the public build folder.
  • yarn clean:dist deletes the dist build folder.
  • yarn clean:cov deletes the coverage report folder.
  • yarn clean deletes all the build/coverage folders.

Style Guide

We use ESLint, StyleLint and Prettier for code style and formatting. Run yarn lint after making any changes to the code. Then, our linter will catch most issues that may exist in your code.

However, there are still some styles that the linter cannot pick up. If you are unsure about something, looking at Airbnb’s Style Guide will guide you in the right direction.

License

By contributing to REACT COOL DIMENSIONS, you agree that your contributions will be licensed under its MIT license.