Skip to content

YoussefSelk/fast-ts-integrator

Fast TypeScript Integrator

fast-ts-integrator logo

npm version License: MIT

A blazingly fast, highly robust CLI tool to flawlessly integrate TypeScript into any new or existing Node.js project. Built by Youssef Selk.

Stop worrying about tsconfig.json errors, module resolution issues, or legacy CommonJS/ESM conflicts. This tool interactively scaffolds the perfect modern TypeScript environment tailored strictly to your needs.

Features

  • 🚀 Universal Compatibility: Works out of the box with new directories, existing Express apps, or complex monorepos.
  • 📦 Smart Module Resolution: Automatically configures TypeScript to support modern NodeNext resolution (flawless ESM & CommonJS support).
  • 🧹 Linter & Formatter Setup: Instantly scaffolds an ultra-fast Biome or ESLint+Prettier toolchain.
  • 🧪 Testing Frameworks: Automatically integrates Vitest or Jest and correctly links @types/jest.
  • Execution Engines: Choose between tsx (the fastest Node.js TS loader) or classic ts-node.

Installation & Usage

You do not need to install this globally. You can instantly execute it in any directory via npx:

npx fast-ts-integrator

Alternatively, if you prefer shorter commands:

npx fast-ts

Interactive Setup

Upon running the CLI, you will be greeted by an interactive menu:

  1. Module System: Choose between ES Modules (import/export) and CommonJS (require).
  2. Execution Engine: Select your preferred runner (tsx or ts-node).
  3. Linter: Pick between Biome, ESLint + Prettier, or skip linting.
  4. Testing Framework: Add Vitest, Jest, or skip testing.

The tool will safely install all necessary dependencies, generate strict and error-free configuration files, and dynamically inject dev, build, lint, and test scripts into your package.json.

Why this tool?

Most boilerplate generators throw raw npm install logs at you, leave you with node_modules type-checking errors (TS2593, TS5110), and don't correctly isolate your test environments.

fast-ts-integrator is designed to be flawless:

  • Zero Errors: Uses skipLibCheck: true and isolatedModules: true to prevent third-party type leaking.
  • Defensive: Handles corrupted package.json files and network drops securely.
  • Clean: Beautifully minimal terminal UI with loading spinners, completely free of messy stdout dumping.

License

MIT License. Created by Youssef Selk.

About

A blazingly fast, zero-configuration CLI tool to seamlessly integrate TypeScript into any new or existing Node.js project.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors