Contributing to validator.js

November 4, 2025 ยท View on GitHub

Welcome to validator.js repository!! We appreciate your interest in contributing to this open library and for helping our community grow.

How to Contribute

Code Contribution

In general, we follow the "fork-and-pull" Git workflow.

  1. Fork the repository on GitHub
  2. Clone the project to your local machine
  3. Work on your fork
    • Install the project using npm install --legacy-peer-deps (see issue)
    • Make your changes and additions
      • Most of your changes should be focused on src/ and test/ folders and/or README.md.
      • Files such as validator.js, validator.min.js and files in lib/ folder are autogenerated when running tests (npm test) and need not to be changed manually.
    • Change or add tests if needed
    • Run tests and make sure they pass
    • Add changes to README.md if needed
  4. Commit changes to your own branch
  5. Make sure you merge the latest from "upstream" and resolve conflicts if there is any
  6. Repeat step 3(3) above
  7. Push your work back up to your fork
  8. Submit a Pull request so that we can review your changes

Run Tests

Tests are using mocha. To run the tests use:

$ npm test

Financial Contribution

We welcome financial contributions on our open collective.

You can opt to become a backer or a sponsor and help our project sustain over time.

Thank you to the people who have already contributed: