Skip to content
This repository has been archived by the owner on Feb 3, 2021. It is now read-only.

GDGVIT/node-template-ts

Repository files navigation

TypeScript Node.JS template

A template to quickstart Node.JS REST APIs with TypeScript

Tests codecov

Functionality

  • Idiomatic and configurable logging
  • Response compression
  • Sane linting and styling guidelines
  • Continuous integration using github actions
  • Tests
  • Code coverage
  • Statically typed language

Running the server

npm start

Note: This will run a server in the development environment. For information on deploying an express application to production, take a look here.

Logging

This directory has 2 files.

  • logger.js exports a winston object which we use for logging. You should modify logger.js to customize your logging configuration.
  • morgan.js exports a pre-configured morgan object to write logs using a stream to winston. It is used to intercept http requests and log the request and response details. For more details, visit the official page for morgan.

Routes

Directory for defining routes. I don't think this needs more explanation.

Additional Information

  • On Linux, UNIX and Mac, running the following command adds ./node_modules/.bin to the path.

    source ./activate

    This makes it easier to run locally installed command packages. This won't be required in many IDEs like Webstorm, but we thought it's a good idea to include it anyway.

  • standard.js has been added as the default linting and styling tool.

    Usage:

    npm run lint

    Formats the entire project, and logs out anything it couldn't fix.

  • mocha is used for testing and chai is used for assertion. chai-http is used to test http endpoints.

    Run all tests using:

    npm test
  • nyc is used as the default coverage tool.

    Upload coverage report to codecov using:

    npm run coverage

    Note: You will need to add the CODECOV_TOKEN to your repository secrets for GitHub actions to work well, and export it as an environment variable to run it locally.

Dependencies

Dependency Usage
compression Response compression middleware
express Express REST API framework
morgan HTTP request logger
winston General purpose logger
nyc Code Coverage tool
standard Linting and styling tool.
chai Assertion Library
chai-http Middleware for chai to test http endpoints

License

License

Made with ❤️ by DSC VIT

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published