[ Web Proxy ]
URL:
Viewing: https://raw.githubusercontent.com/hackmcgill/hackerAPI/dev/docs/getting-started.md [Back]  [Original]

# How to get started

## What you will need before you can use this

* A google cloud provider account:
  * Google storage bucket.
* Sendgrid account and the sendgrid_api_key

## Setting up this repo

1. Clone the repository: `git clone https://github.com/hackmcgill/hackerAPI.git`
2. Make sure you have the following tools:
    1. `git`: 
    2. `mongodb`: 
        1. Make sure you also have the `/data/db` directory.
        2. To test the installation, run `mongod`.
    3. `node`: 
    4. `npm`: .
    5. `Postman`: . We use this for testing the API locally.
3. Make sure you have the following (only if you are going to be publishing this as a kubernetes cluster on google cloud):
    1. `kubectl`: 
    2. `gcloud`: 
4. Create a `.env` file in the root directory, and populate the fields as per `.env.example`.
5. run `npm install`

## Setting up the database

1. Determine which environment the database you want to seed belongs to (`deployment`, `development`, or `test`).
2. Navigate to `package.json`, and confirm that at the `seed` script, `NODE_ENV` is set to the proper environment.
3. Run `npm run seed`.

## Testing the API

In order to test that you have set up the API properly, run `npm run test`.

Web Proxy Viewer  |  New URL  |  Original Page