Node-TypeScript-Express-Docker-Starter is a template repo for building a Node.js APIs with TypeScript, Express and Docker. This template contains a minimal ESLint configuration to enforce coding styles, and comes equipped with Jest for unit and integration testing. Additionally, this project's API routes are structured similarly to how components are organized in an Angular project. Controllers are grouped by the API resource they serve, and the associated unit (spec.ts) and integration (e2e.ts) files live in the same directory.

Install Docker Desktop, VS Code and Git. Click the green Use this template button to copy this repo to your GitHub account. Once you've copied the repo, clone it to your workspace (be sure to replace my URL with the URL to the repo you generated by clicking Use this template):

git clone https://github.com/bobbyg603/node-typescript-express-docker-starter

Install the project's dependencies:

npm i

Run the unit and integration tests to ensure everything installed correctly:

npm test && npm run e2e

You can also run and debug tests from within the VS Code Testing Explorer by installing Jest Test Explorer.

If you'd like to automatically build and restart the development sever when source files are changed you can can run the watch command:

npm run watch

The development server can also be started without watching the local file system or attaching the debugger:

npm start

If you'd like to attach the VS Code Debugger to a Node.js instance running on your local machine use the Launch Program task.

The VS Code Debugger can also be attached to a Node.js instance running inside a Docker container via the Docker: Node.js Launch task.

The development server should begin listening for web requests. If you navigate to http://localhost:3000 in your browser you should see something that resembles the following:

If you believe that this example can be improved, please open an issue or submit a pull request!