patrickniyogitare28 / node-ts-super-plate

A boilerplate for a node web api application. It's designed to work out-of-the-box.

Boilerplate

A boilerplate for a node web api application. It's designed to work out-of-the-box.

Getting started

git clone https://github.com/PatrickNiyogitare28/node-ts-super-plate.git

cd node-boilerplate

npm install

npm start

curl localhost:8080/api/greeter?name=Bill

• Should return: Hello, Bill!

Building

npm run build

Testing

npm test

Running in Docker

Building a production docker image

$ docker build . -t <docker-username>/app-name
# docker build . -t patrickniyo/stackoverflow-auth-microservice/

Running the production docker image in a container

$ docker run -p <app-port>:<localhost-port> [image-name or image-id]
# docker run -p 5000:5000 patrickniyo/stackoverflow-auth-microservice/

Requirements

• Node.js®

Recommended

• Visual Studio Code

  There are included vscode specific settings included to streamline things.

  See Below.

Windows-specific

• Windows Subsystem for Linux

  Using WSL on Windows is just a smoother developer experience.

Includes

• TypeScript

• ESLint

• typescript-ioc

  IoC container for typescript.

• module-alias

  Allows your transpiled code to actually make use of the paths section of your tsconfig.json file.

• Mocha

  For testing.

• Chai Assertion Library

  Assertion library.

Config files

eslintrc.json

Has all the rules/config for ESLint.

mocharc.jsonc

Config settings for mocha when running it from the command line.

• ts-node/register - for compilation.

• module-alias/register - for path alias recognition.

package.json

scripts

• clean - removes dist folder.

• build - runs clean and builds app.

• start - cleans, builds, and starts app.

• test - runs mocha with settings in mocharc.jsonc.

_moduleAliases

Needed for module-alias package. Should match keys in paths of tsconfig.json as such (note the lack of wildcard in package.json):

package.json

{
  // ...
  "_moduleAliases": {
    "@service": "dist/service"
    // ...
  }
  // ...
}

tsconfig.json

{
  "compilerOptions": {
    // ...
    "paths": {
      "@service/*": ["./src/service"]
      // ...
    }
    // ...
  }
}

tsconfig.json

include key is for including any source files that you want VSCode to recognize.

tsconfig-build.json

Used only for build to exclude the test folder in compilation.

Visual Studio Code

After cloning and prior to opening in Visual Studio Code, go ahead and run the install and build commands to prevent it barking at you.

npm install

npm run build

Once you have the folder open in Visual Studio Code, it will prompt you to download some recommended extensions... Do that...

Recommended Extensions

ESLint

Code linter for TypeScript and JavaScript

Mocha Sidebar

Sidebar test runner for Mocha Tests