Skip to main content

Contributing

You can contribute to the project by helping report bug issues, features, and code development.

Prerequisites​

If you want to use docker you can skip the NodeJS and Rust install.

Development​

First, you must checkout all repos into the same directory. Some of these repos are optional, but checking them all out allows you to hop around the code more easily. If you are not going to develop you can use docker compose to run the images.

Create a root directory for all of the files ex: mkdir a11ywatch_project && cd a11ywatch_project.

Clone all the repositories (or only the required ones).

git clone https://github.com/a11ywatch/a11ywatch.git
git clone https://github.com/a11ywatch/a11ywatch-core.git
git clone https://github.com/a11ywatch/pagemind.git
git clone https://github.com/a11ywatch/a11ywatch-web-lite.git
git clone https://github.com/a11ywatch/chrome.git
git clone https://github.com/a11ywatch/mav.git
git clone https://github.com/a11ywatch/crawler.git

Navigate to primary repo for main setup and start.

cd a11ywatch

Docker​

You can use the docker compose --file docker/docker-compose.dev.yml up to start up the docker instance in development mode.

If you want to run the production application run the command docker compose --file docker/docker-compose.yml up.

Local​

In order to start the project locally you need to navigate to each of the folders and run the npm run dev command. We might make a script for this if people tend to lean towards developing local instead of docker.

Pushing Changes to Github​

After you have the development instances up you can submit a PR to the repos directly for review.