Skip to content

Latest commit

 

History

History
67 lines (40 loc) · 2.35 KB

CONTRIBUTING.md

File metadata and controls

67 lines (40 loc) · 2.35 KB

Contributing

Thanks for taking the time to contribute to this project!

How to help?

There are multiple tasks you can do in order to help us, for example:

Contributing workflow

In order to make a code contribution, create a fork of WebCrate by clicking the "Fork" button on GitHub and cloning the repo to your local machine.

Please use the develop branch as a base for your contribution and make your changes on a new branch.

Ensure that you open a discussion to discuss the changes before submitting a PR.

Once you're finished, push your branch to your repo and create a pull request!

Development

The WebCrate app constists of a Nuxt frontend with a Express backend. It uses Deta Base as its database and thus requires that you sign up for a Deta account to use it during development.

Once you are signed up, follow the steps below to get a local version of WebCrate up and running:

  1. Clone this repo
git clone https://github.com/WebCrateApp/webcrate && cd webcrate
  1. Install the dependencies
npm install
  1. Create .env file with your Deta Project Key
echo "DETA_PROJECT_KEY=your key" > .env
  1. Run the app locally with hot reloading enabled
npm run dev

Linting

ESlint is used for linting. It's recommended to add the corresponding extension to your editor. It's also possible to run the lint script with the following command:

npm run lint

Verify that there are no lint errors before opening a PR.

Testing

Make sure your changes don't break anything. There are currently no integration/unit tests available.

That's it, happy coding!