Description

Crowdfunding API.

---

Prerequisites

You need Node.js installed on your local machine. You can also do it using nvm.

If you want to use Docker and Docker Compose, you have to install Docker Desktop first, check this link.

---

Installation

We are using yarn, so you will install all the libs with the following command:

$ yarn install

IMPORTANT: To configure git-hooks you must have at least git version 2.9. If not, postinstall script won't work, thus the hooks won't.

---

Define .env variables

You can pick .env.template as a template file to create a new .env file. Template file has just mock data and you have to change those values.

PS: If you are using Docker, be sure all the env vars with prefix MONGO_... are defined properly. If not, you just need to define MONGO_URI_CONNECTION which will point at your MongoDB instance.

🚨 MONGO_URI_CONNECTION: If you are using Docker, take care about the values you assign. They should be "mongodb://MONGO_USERNAME:MONGO_PASSWORD@MONGO_CONTAINER_NAME:MONGO_PORT/MONGO_DATABASE"

🚨 Only when using Docker: Check database/mongo-init.js file, you has to modify the values of the file:

db.createUser({
  user: 'DB_USER', // Same value as MONGO_USERNAME
  pwd: 'DB_USER_PASS', // Same value as MONGO_PASSWORD
  roles: [
    {
      role: 'readWrite',
      db: 'DB_NAME', // Same value as MONGO_DATABASE
    },
  ],
});

---

Have you run the DB seed process?

In order to get your DB seeded with metadata you need to run a yarn command. Before doing that, be sure you update the value of MONGO_URI_CONNECTION inside .env. IMPORTANT NOTE: If you are using Docker, please change the host name (from the container name to localhost) because the script is not run inside the Docker network. Once you have updated the MONGO_URI_CONNECTION run the following command:

yarn run db:seed

---

Running the app

• Using Docker

# watch mode
docker-compose up

• Without Docker (IMPORTANT: You have to have a MongoDB up and running)

# development
$ npm run start

# watch mode
$ npm run start:dev

# production mode
$ npm run start:prod

IMPORTANT:

We have added a pre-commit and pre-push hooks, so linter and test are run before pushing the code to the remote. If for some reason you don't want these processes to be run, add the flag --no-verify, for example:

# commit
git commit --no-verify -m "commit message"
# push
git push --no-verify

---

Testing

🕵🏼‍♂️ In progress

Deploy on GCloud

• Install gcloud CLI.
• Useful link to set up your gcloud account
• Build project with yarn build
• Upload to gcloud: gcloud app deploy