To start using this project, you need to get your computer configured so you can build and execute the code. To do this, follow these steps; the specifics of each step (especially the first two) will vary based on which operating system your computer has:
-
Install git (v2.9+). After installing you should be able to execute
git --version
on the command line. -
Install Node LTS (v10.14.X), which will also install NPM (you should be able to execute
node --version
andnpm --version
on the command line). -
Install Yarn (v1.12+). You should be able to execute
yarn --version
afterwards. -
Clone your repository by running
git clone REPO_URL
from the command line. You can get the REPO_URL by clicking on the green button on your project repository page on GitHub.
Once your environment is configured you need to further prepare the project's tooling and dependencies. In the project folder:
-
yarn install
to download the packages specified in your project's package.json to the node_modules directory. -
yarn build
to compile your project. You must run this command after making changes to your TypeScript files. -
yarn test
to run the test suite.
WebStorm should be automatically configured the first time you open the project (WebStorm is a free download through their students program). For other IDEs and editors, you'll want to set up test and debug tasks and specify that the schema of all files in test/queries
should follow test/query.schema.json
.