Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

Contributing to Nightwatch

Contributions to Nightwatch are always welcome but please try to follow these guidelines when sending in something as it will help addressing the issue quicker and more smoothly.

Please do not ask for assistance in the Issues list. Use the Mailing List or StackOverflow to ask questions and seek help.

Assistance requests posted in the Issues list are usually closed right away.

Submit an issue

Before submitting a new issues, try searching for a similar one here: and add your scenario there and anything else which you think will help with fixing it;

If you are filing a bug report, regression issue or what it appears to be strange behaviour, please follow the steps below:

  1. Please write an elaborate title which explains the problem as accurate as possible For instance:
  • not helpful: "Issue with tags"
  • much better: "Tags don't work when combined with --skiptags option"
  1. Include a sample test which reproduces the problem you're experiencing. The test should be against a public url. The test and other info should be posted inline, attachments will be ignored;
  2. Include the verbose output, if possible (run nightwatch with --verbose argument);
  3. Include your configuration (try to leave out the irrelevant bits);
  4. Also include: Nightwatch version, Node.js version, OS version and Webdriver/Selenium Server version;
  5. Please try not to report issues you have with individual browser drivers which cannot or should not be solved in Nightwatch.

Requesting a feature

Feature requests are welcome.

  1. Indicate in the issue title that it is a feature/enhancement request
  2. Explain the use case and include a sample test case and/or usage, if possible
  3. Try to submit enhancements that you cannot build with custom commands/assertions and something that will benefit the community
  4. Same as for issues, add your comments/vote to an existing feature request if you'd like to see it implemented

Submitting a pull request

Thanks in advance for your contribution.

  1. Follow the usual git workflow for submitting a pull request
  • fork the project
  • create a new branch from master (e.g. features/my-new-feature or issue/123-my-bugfix)
  1. If you're fixing a bug also create an issue if one doesn't exist yet
  2. If it's a new feature/enhancemnt explain why do you think it's necessary
  3. If your change include drastic or low level changes please discuss them to make sure they will be accepted and what the impact will be
  4. If your change is based on exisiting functionality please consider refactoring first. Pull requests that duplicate code will not make it in very quick, if at all
  5. Do not include changes that are not related to the issue at hand
  6. Follow the same coding style with regards to spaces, semicolons, variable naming etc.
  7. Always add tests - after all this is a testing framework