Express JS Starter pack using Typescript and configuration based JSON for different environment.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Express is a light-weight web application framework to help organize your web application into an MVC architecture on the server side. TypeScript enables us to develop a solid web applications using Express on Node.js.

  1. npm start
  2. It is used to run the project in development, it will reload the project while the source get changed.

  3. npm run build:prod
  4. It is used for the production build, which uses the webpack-cli for the build and provides a single output file with required additional file such as package.json, configuration files.
    The output file name and the files to copy can be managed in webpack.config.js

To run the project
  • Clone or download
  • Yarn install/npm install
  • npm start
  • http://localhost:40401/

Confiuration for different environment

we can add the json files for different environment /config/ 
  "Config": {
    "port": 40401,
    "appConfig": {
      "version": "1.0.0",
      "name": "express-api",
      "env": "development"
 Configure the port db and etc...

IConfig.ts is an interface for the root tags to get the properties in the code. 
  export interface IConfig {
    appConfig: any;
    DBConnections: any;
    port: number;

To set the enviroment.
    export class AppSetting {

        public static Env = Environment.Dev;

        public static getConfig(): IConfig {
            let configManager = new ConfigManager();
            return cloneDeep(configManager.Config);

ConfigurationManager is class used to read the configuration json files using nconf. It will stored in memory for the first request and served from memory from the subsequent request.
            if (!nconf.get('Config')) {
            this.Config = nconf.get('Config');
            if (!this.Config) {
                Logger.error('Unable to read the config file');


Configure the environment.
    export enum Environment {
        Dev, Production, Local


Database Connectivity:
Sequelize is used to connect the database. The configuration is managed in config.{env}.json. The dialect options is used to configured the database server.

"DBConnections": {
      "default": {
        "user": "sa",
        "password": "sql@123",
        "options": {
          "host": "localhost", // server name
          "database": "testdb", // database name
          "requestTimeout": 300000,
          "dialect": "mssql",
          "operatorsAliases": false,
          "logging": true, //Enable the sequelize logger for queries for dev mode.
          "dialectOptions": {
            "encrypt": false

How to pass the Parameter to SQL Query

If the JSON and parameter name are same, we can pass the json object to the sql manager as below:
public addCustomer(customer: ICustomer) { let query = "INSERT INTO customers (name,address) VALUES(:Name,:Address)"; return this.db.Insert(query, customer); }

Adding parameter without JSON Object

public deleteCustomer(id) { let query = "DELETE FROM customers WHERE Id=:id"; this.db.addInputParameter("id", id); return this.db.Delete(query); }


Integrated Swagger UI. Add the swagger json in swagger-docs. Ref customer.swagger.json

Swagger.controller.ts for adding the swagger routes. export class SwaggerController {

public static configure(app: Express) {
    app.use('/swagger/customer', swaggerUi.serve, swaggerUi.setup(customer)); //route for the swagger ui


To run the swagger example http://localhost:40401/swagger/customer