Simple Rest Endpoints with Nest.js backend, ReactJS frontend, Postgres in Docker

For development, you will need Docker and Node.js installed on your device.

You can install docker and nodejs easily with following commands.

Getting Started

Docker

Docker installation on macOS

brew install --cask docker

Other operating systems

Please visit the official Docker website

Node

Node installation on macOS

$ brew install nodejs
$ npm install -g typescript

Other Operating Systems

You can find more information about the installation on the official Node.js website.

If the installation successful finished, you can run the following commands to validate.

$ node --version
v12.22.10

$ npm --version
6.14.16

Install the app

$ git clone https://github.com/tayfunyasar/nestjs-reactjs-docker
$ cd nestjs-reactjs-docker
$ npm i

Run Postgres via Docker

docker-compose up

Backend

Change directory into the backend and install its dependencies

cd backend
npm install

Create .env file

Once the installation process is complete, you can check .env and backend/src/envs/:

touch dev.env

Open the newly created file and add the following code:

DATABASE_HOST=localhost
DATABASE_PORT=5432
DATABASE_NAME=app
DATABASE_USER=docker
DATABASE_PASSWORD=docker

Ensure that you replaced the database variables with docker-compose variables.

Run the application

Open another terminal and still within the backend project directory run the application with:

npm run start

This will start the backend application on port 8089. This was modified to avoid confliction with the frontend application which by default will run on port 3000

Frontend

Open another terminal and navigate to the ./frontend folder to setup the frontend

Frontend dependencies

cd frontend
npm install

Run the frontend app

npm start

Create .env file and include Auth0 App credentials

Create a .env file as shown here:

touch .env

Open the file and paste the following code in it:

BASE_URL=http://localhost:8089/api

Test the application

Finally open your browser and view the application on http://localhost:3000

Prerequisites

Node.js, Docker

Built With

Node.js Nest.js React.js TypeScript Postgres

sources

typeorm implementation: https://medium.com/@gausmann.simon/nestjs-typeorm-and-postgresql-full-example-development-and-project-setup-working-with-database-c1a2b1b11b8f

common/envs implementation: https://github.com/hellokvn/medium-nest-typeorm-postgres-sample/tree/main/src/common/envs

tayfunyasar / nestjs-reactjs-docker