Hi! I'm really excited that you are interested in contributing to Vorms. Before submitting your contribution, please make sure to take a moment and read through the following guide:
The Vorms repo is a monorepo using pnpm workspaces. The package manager used to install and link dependencies must be pnpm.
Here is a quick guide to doing code contributions to the library.
-
Fork and clone the repo to your local machine
git clone https://github.com/YOUR_GITHUB_USERNAME/vorms.git
pnpm install
-
Create a new branch from
master
with a meaningful name for a new feature or an issue you want to work on -
If you've added a code that should be tested, ensure the test suite still passes.
pnpm test
Try to write some unit tests to cover as much of your code as possible.
-
Ensure your code lints without errors
pnpm lint
-
Ensure build passes.
@vorms/core
pnpm build:core
@vorms/resolvers
pnpm build:resolvers
-
Push your branch.
-
Submit a pull request to the upstream vorms repository.
-
Choose a descriptive title and describe your changes briefly.
Please follow the coding style of the project. Vorms uses eslint and prettier. If possible, enable their respective plugins in your editor to get real-time feedback. The linting can be run manually with the following command: pnpm lint
and pnpm format