Skeleton for Node.js applications written in TypeScript

Our main purpose with this Skeleton is to start server application with node js and typescript.

Try it!! I am happy to hear your feedback or any kind of new features.

• Quick start
• Integrated eslint, prettier and husky
• Common Error Handler
• Common Response Handler
• Simple and Standard scaffolding
• Followed SOLID Principles
• Based on Typescript Syntax
• Simple Enviroment Configuration
• Global Enviroment Object
• Request/Response Encryption & Decryption Implementation
• Easily Add new feature
• Integrated winston Logger
• Production Ready Skeleton
• Follwed Production Ready Best Practices: Security
• Added only used npm modules
• Unit & Integration Test Cases

• express, @types/express
• @types/node
• typescript
• dotenv
• cors
• helmet
• http-status-codes
• winston, @types/winston

  flowchart TD;
      A[Start the application]--NODE_ENV=local-->B[Development Mode];
      A--NODE_ENV=test-->C[Test Mode];
      A--NODE_ENV=production-->D[Production Mode];

      B-->E[Install the dependencies `npm install`];
      C-->F[Install the dependencies `npm install`];
      D-->G[Install the dependencies `npm install`];

      E--creat local environment `.env.local`-->H[Start the application `npm start`];
      F--creat test environment `.env.test`-->I[Create the build `npm run build`];
      G--creat prod environment `.env.prod`-->J[Create the build `npm run build`];

      I-->K[Start the application `npm start:test`];
      J-->L[Start the application `start:production`];

• Clone the Application git clone https://github.com/santoshshinde2012/node-boilerplate.git
• Install the dependencies npm install
• Start the application npm start

• Install the dependencies npm install
• Create the build npm run build
• Start the application npm run start:production
• Before starting make sure to creat prod environment .env.prod file

Set the APPLY_ENCRYPTION environment variable to true to enable encryption.

You can directly access the environment attributes in any component/file using global environment object. For more details please check file src/global.ts.

Example

To access the applyEncryption attribute from Envionment class to Response Handler, write environment.applyEncryption;

• ${host}/api/status/system - Return the system information in response
• ${host}/api/status/time - Return the current time in response
• ${host}/api/status/usage - Return the process and system memory usage in response
• ${host}/api/status/process - Return the process details in response
• ${host}/api/status/error - Return the error generated object in response

• Skeleton for Node.js Apps written in TypeScript
• Setup Eslint Prettier and Husky in Node JS Typescript Project

• Because files are not executable by default; they must be set to be executable.

chmod ug+x .husky/*
chmod ug+x .git/hooks/*

• Don’t use deprecated or vulnerable versions of Express
• Use TLS
• Use Helmet
• Use cookies securely
• Prevent brute-force attacks against authorization
• Ensure your dependencies are secure
• Avoid other known vulnerabilities
• Additional considerations