This cli tool generates a thin, unopinionated Express application with TypeScript. It's designed to create a project structure, initialize version control, install dependencies, and configure TypeScript, ESLint, Prettier, and Jest for testing.

🍦 Sets up an Express server with TypeScript

🍦 Configures ESLint with TypeScript support

🍦 Adds Prettier for code formatting

🍦 Sets up Jest and Supertest for endpoint testing

🍦 Initializes a new Git repository

🍦 Configures Husky for pre-commit hooks

Before running this script, make sure you have the following installed:

• Node.js (v16 or higher)
• yarn (default package manager)
• git

Install the package globally using npm:

npm install -g generate-express-ts

Or using Yarn:

yarn global add generate-express-ts

After installing the package globally, you can set up a new Express TypeScript application by running:

generate-express-ts <project-name>

Replace <project-name> with your desired project directory name. If you don't specify a name, it defaults to my-express-ts-app.

The script will create a new directory with the given project name (or the default name) and set up the project structure and configurations within that directory.

The script will create the following files and directories:

• .eslintrc.yml: ESLint configuration file
• .prettierrc.yml: Prettier configuration file
• .gitignore: Basic .gitignore file for a Node.js project
• app.ts: Entry point for the Express application
• app.spec.ts: Sample test file using Jest and Supertest
• tsconfig.json: TypeScript configuration file
• .lintstagedrc: Configuration for lint-staged
• package.json: Node.js package manifest with scripts for common tasks
• src/: Directory for source code
• src/api/: Directory for API endpoints
• src/api/health/: Health check endpoint, accessible at /api/health

The generated package.json includes the following scripts:

• start: Runs the Express server using ts-node
• dev: Runs the Express server using nodemon
• build: Compiles TypeScript files to JavaScript in the dist directory
• test: Runs tests using Jest
• serve: Runs the Express server using node (requires build to be run first)

Distributed under the MIT License. See LICENSE for more information.

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Rafay Choudhury - x: @rafay_io - website: rafay.io