pages235/CONTRIBUTING.md

1.2 KiB

Contributing Guide

After forking the repository, run the following commands to get started:

  1. Ensure you have Node.js and pnpm installed. To install pnpm run npm i -g pnpm.
  2. Install dependencies: pnpm i
  3. Start the project in development mode: pnpm start

A few notes:

  • Use next branch for development and as base & target branch for pull requests if possible.

  • To link dependency locally e.g. flying-squid add this to pnpm > overrides of root package.json: "flying-squid": "file:../space-squid", (with some modules pnpm link also works)

  • It's recommended to use debugger for debugging. VSCode has a great debugger built-in. If debugger is slow, you can use --no-sources flag that would allow browser to speedup .map file parsing.

  • Some data are cached between restarts. If you see something doesn't work after upgrading dependencies, try to clear the by simply removing the dist folder.

  • The same folder dist is used for both development and production builds, so be careful when deploying the project.

  • Use start-prod script to start the project in production mode after running build script to build the project.