A modern, lightweight, and opinionated boilerplate for building robust Node.js applications with TypeScript. Designed for speed, type safety, and developer experience.

This repository provides a solid foundation for your next Node.js project. Instead of spending hours configuring build tools, linting, and testing frameworks, you can jump straight into writing your application logic.

• Minimalist: No bloat—only the essential tools to get you moving.
• Type-Safe: Strict TypeScript configuration for catching errors early.
• Developer-Friendly: Integrated linting, formatting, and high-performance testing.
• Production-Ready: Follows modern ESM standards and Node.js best practices.

• Runtime: Node.js (>= 20.19)
• Language: TypeScript 5.8
• Testing: Vitest (Vite-native test runner)
• Linting: ESLint 9 (with @typescript-eslint and @stylistic)
• Execution: ts-node for seamless TypeScript execution

git clone <your-repo-url>
cd template-node-basic
npm install

cp .env.example .env

npm run dev

Run the test suite using Vitest:

npm test

├── src/                # Source code
│   └── index.ts        # Entry point
├── eslint.config.js    # Modern ESLint flat configuration
├── tsconfig.json       # TypeScript compiler settings
├── vitest.config.ts    # Testing configuration
└── .env.example        # Template for environment variables

• Zero-Config Testing: Vitest is pre-configured for blazing-fast unit testing.
• Modern ESM: Built from the ground up to use standard JavaScript modules ("type": "module").
• Consistent Code Style: Pre-configured ESLint rules ensure your codebase remains clean and maintainable.
• Native Env Support: Uses Node's native flag, reducing dependency on third-party loaders for local development. --env-file

This project is licensed under the MIT License. Built with ❤️ by Roman Rakhman