Contributing to Verdaccio
We are happy you wish to contribute this project, for that reason we want to board you with this guide.
How I contribute?
Ways to contribute
There are many ways to contribute to the Verdaccio Project. Here’s a list of technical contributions with increasing levels of involvement and required knowledge of Verdaccio's code and operations.
Please read carefully this document. It will guide you to provide maintainers and readers valuable information to boots the process solve the issue or evaluate your proposal.
Reporting a Bug
We welcome clear bug reports. If you've found a bug in Verdaccio that isn't a security risk, please file a report in our issue tracker. Before you file your issue, search to see if it has already been reported. If so, up-vote (using GitHub reactions) or add additional helpful details to the existing issue to show that it's affecting multiple people.
Check if there's a simple solution in the website.
Some of the most popular topics can be found in our website(http://www.verdaccio.org/docs/en/installation.html)
Questions & Chat
Using the issue tracker
The issue tracker is a channel were mostly users/developers post.
I want to report a bug
We considere a bug a feature that is not working as is described in the documentation. Before reporting a bug follow the next steps:
Use the GitHub issue search — check if the issue has already been reported.
Check if the issue has been fixed — try to reproduce it using the latest master or development branch in the repository.
Verdaccio still does not support all npm commands due either in the initial design were not considered important or nobody has request it yet.
A new feature is always welcome, thus, analyse whether your idea fits in the scope of the project and elaborate your request providing enough context, for instance:
- A wide description the advantages of your request.
- It's compatible with
- You might implement your feature and provide a forked repository as example.
- Whatever you have on mind
Submitting a Pull Request
The following are the general steps you should follow in creating a pull request. Subsequent pull requests only need to follow step 3 and beyond:
- Fork the repository on GitHub
- Clone the forked repository to your machine
- Make your changes and commit them to your local repository
- Rebase and push your commits to your GitHub remote fork/repository
- Issue a Pull Request to the official repository
- Your Pull Request is reviewed by a committer and merged into the repository
Note: While there are other ways to accomplish the steps using other tools, the examples here will assume the most
actions will be performed via the
git command line.
Make Changes and Commit
At this point you have ready your changes, your new feature it's ready to be shipped, but, to avoid delays to merge, please be aware the build must past.
Before commit, run the test command:
It won't have eslint errors and all test must past. Then, and only then, you should push and ship your PR.
Git Commit Guidelines
We follow the conventional commit messages convention in order to automate Changelog generation and auto semantic versioning based on commit messages.
- feat: A new feature
- fix: A bug fix
A commit of the type feat introduces a new feature to the codebase (this correlates with MINOR in semantic versioning).
A commit of the type fix patches a bug in your codebase (this correlates with PATCH in semantic versioning).
Commits types as
chore: are valid but has no effect on versioning, but, it would be great if you use them.
npm run commitmsg to check your commit message.
All PR that does not follow the commit guidelines will be hold until messages are fixed.
Any change in the sour code must to include test update, if you need support about how test works, please refers to the following guide. Please include test whether is a new feature, otherwise will be hold and never be merged.
Documentation, website, build, deployment, assets or flow types are excluded in this section
Plugins are Add-ons that extend the functionality of the application. Whether you want develop your own plugin I'd suggest do the following:
- Check whether there is a legacy sinopia plugin for the feature that you need at npmjs.
- There is a life-cycle to load a plugin you should keep on mind.
- You are free to host your plugin in your repository, whether you want to host within in our organization, feel free to ask, we'll happy to host it.
- Try a describe widely your plugin to provide a deeply understanding to your users.