Make sure that what you trying to fix really a bug, or if adding feature that is good way to solve your task.
- Fork the repo:
- Use nodejs 20 (recommended, should work in others but not tested)
- Run
npm run install
in root folder (it will install all deps and do other required steps) - Install Playwright , can use
distrobox
if you on Linux distro other than Ubuntu, should work as is for Windows and Mac. - Run
npm run dev
for run the demo project in watch mode
-
Write code! Add some feature or fix bug.
2.1 Use conventional commit format
fix
andfeat
will bump the version, those tags should be used only for files inside./packages/urlstate
orpackage.json
.There are also
ci
,build
,docs
,style
,test
,chore
andrefactor
. -
Check that all tests passed(unit and e2e) and add tests for your code. Run all tests witn
npm run test
You can run tests separately with npm run test:unit
and tests npm run test:int
+ npm run dev
Use npm run kill
if some processes hang.
-
Update readme and example (if needed)
-
Make commit and Pull Request, review, approval and merge.