We welcome you to join the development of vtk.js. This document will help you through the process.
Please follow the coding style:
- Use soft-tabs with a two space indent.
- Don’t put commas first.
The vtk.js source is maintained on GitHub.
Fork vtk.js into your user’s namespace on GitHub.
Clone the repository to your computer.
$ git clone https://github.com/<username>/vtk-js.git
$ cd vtk-js
Run the install script for vtk.js dependencies:
$ npm install
Create a feature branch.
$ git checkout -b new_feature
Start hacking. Additional information on how to create class/test/example can be found
here in the Development section.
$ edit file1 file2 file3
$ git add file1 file2 file3
Use Commitizen to create commits
$ npm run commit
Push commits in your feature branch to your fork in GitHub:
$ git push origin new_feature
Visit your fork in Github, browse to the “Pull Requests“ link on the left, and use the
“New Pull Request“ button in the upper right to create a Pull Request.
For more information see:
Create a Pull Request
vtk.js uses GitHub for code review and Travis-CI to test proposed patches before they are merged.
Don’t modify the version number in
Your pull request will only get merged when tests passed. Don’t forget to run tests before
$ npm test
The vtk.js documentation is part of the code repository and is entirely written in
If you encounter problems using vtk.js you may be able to find the solutions in the
troubleshooting docs, in an
existing GitHub issue, or via the
If you can’t find the answer, please
report a new issue on GitHub.