Skip to content

Integrating TypeScript with KOA2 to hit the ground running faster

Notifications You must be signed in to change notification settings

ddimaria/koa-typescript-starter

Repository files navigation

KOA2 TypeScript Starter

Build Status Coverage Status

A NodeJS server built with the KOA2 framework using TypeScript.

Technologies Used:

Prerequisites

Installation

First, clone this repo and cd into the main directory. Then:

npm install

Development

During development, the /app folder is being watched for changes.

All changes invoke the TypeScript compiler, which restarts the app upon completion.

npm run watch

Build the Server

To compile the TypeScript code and place into the /dist folder:

npm build

Code Linter

A TypeScript linter has been added to keep code consistent among developers.

npm run lint

To autofix linting errors (not all errors are auto-fixable):

npm run fix

Tests and Coverage

The test coverage percentage should be 90% or greater for any submitted PRs.

For TDD, invoke testing by:

npm test

For an html and text coverage report (html located in the /coverage folder):

npm run coverage

Docker

To build a container using the dockerfile:

npm run image:build -- --no-cache

API

For a swagger version of this documention, see http://localhost:3000/swagger (requires this server to be running).

Releases

No releases published

Packages

No packages published