Express with TypeScript's application generator.

What is it?

Creates a new express application similar to the express-generator module. Except this new application is configured to use TypeScript instead of plain JavaScript.

This project complies with Typescript best practices listed here.

Why express-generator-typescript?

NodeJS is great for the rapid development of web-projects, but is often neglected because of the lack of type safety. TypeScript solves this issue and (along with its linter file) can even make your code more robust than some other static languages like Java.

There are some other tools out there to generate express apps with TypeScript such as express-generator-ts, but these either haven't been updated in a while or install a lot of junk in your project (such as an ORM).

Due to the heavy use of single-page-applications, no view-engine is configured by default. Express is only setup with the minimal settings for calling APIs and serving an index.html file. All the tools you need to run for development (while restarting on changes), building, testing, and running for production are packaged with this library.

In addition, relative paths are also setup, so you don't have to go through the trouble of installing and configuring tsconfig-paths and module-alias. Just make sure to update paths in tsconfig.json and _moduleAliases in preload.js if you want to add/edit the relative paths.

Sample-project

When you run express-generator-typescript, it sets up a simple application with routes for adding, updating, deleting, and fetching user objects. This is just to demonstrate how routing is done with express.

--with-auth option no longer available for version 2.5+

For the command-line, you used to be able to pass the --with-auth option to generate an app which required a login before using the routes; however, maintaining two separate projects became quite cumbersome. If you want an example of how to do authentication in expressjs with json-web-tokens you can refer to this sample project here.

Installation

$ Just use 'npx'
  Or
$ npm install -g express-generator-typescript

Quick Start

The quickest way to get started is use npx and pass in the name of the project you want to create. If you don't specify a project name, the default express-gen-ts will be used instead. If you want to use yarn instead of npm, pass the option --use-yarn.

Create the app: With no options: $ npx express-generator-typescript With all options (order doesn't matter): $ npx express-generator-typescript --use-yarn "project name"

Start your express-generator-typescript app in development mode at http://localhost:3000/:

$ cd "project name" && npm run dev

Available commands for the server.

• Run the server in development mode: npm run dev or npm run dev:hot.
• Run all unit-tests: npm run test or npm run test:hot.
• Run a single unit-test: npm test -- --testFile="name of test file" (i.e. --testFile=Users).
• Check for linting errors: npm run lint.
• Build the project for production: npm run build.
• Run the production build: npm start.
• Check for typescript errors: npm run type-check".

Debugging

During development, express-generator-typescript uses nodemon to restart the server when changes are detected. If you want to enable debugging for node, you'll need to modify the nodemon configurations. This is located under nodemonConfig: in package.json for the server and ./spec/nodemon.json for unit-testing. For the exec property, replace ts-node with node --inspect -r ts-node/register.

Note for VSCode users

In order to use eslint as a typescript file with VSCode, you need to add a setting to your eslint options. At the root of your project, add a .vscode/settings.json file (if you don't have one already) and add the option unstable_ts_config:

  "eslint.options": {
    "flags": ["unstable_ts_config"]
  }

Happy web deving :)

License

MIT