TSCX

A tsc wrapper with many convenient features. Bring the nodemon + JavaScript development experience to TypeScript.

Background

When we are using JavaScript, we usually run nodemon main.js. Then, application will automatically restart when js file changes. It's a great development experience. Why can't TypeScript? The reason is the compilation (tsc). Because of this, some edge cases are inconvenient just using tsc. For example:

• Remove the output folder before compilation started
• Copy non-ts files to output folder after compilation finished
• Execute app entrance file immediately once compilation finished
• Watch source files, repeat steps above and restart the app

Now you can run one line of command to solve the problems. Better development experience!

1npx tscx --project tsconfig.build.json --remove --copyfiles --watch --exec bootstrap.js

Happy hacking!

Highlight

• Same usages as tsc with few additional options.
• Remove output folder before every compilation.
• Copy non-ts files to output folder after every compilation.
• Execute js file after compilation success.
• Respect tsconfig.json.
• ESM.

Install

1npm install typescript @nrm/tscx -D

Usage

1# Equivalent to `npx tsc`
2$ npx tscx
3
4# Equivalent to `npx tsc --project tsconfig.build.json --watch`
5$ npx tscx --project tsconfig.build.json --watch
6
7# Remove output folder before compilation and then compile ts code.
8$ npx tscx --remove
9
10# Compile ts code and then copy non-ts files to output folder after compilation.
11$ npx tscx --copyfiles
12
13# Compile ts code and execute bootstrap.js after successful compilation.
14$ npx tscx --exec bootstrap.js
15
16# Compile ts code in watch mode and execute bootstrap.js after every successful compilation.
17$ npx tscx --project tsconfig.build.json --watch --exec bootstrap.js
18
19# Remove => Compile => Copy => Execute => Edit any file to repeat it
20$ npx tscx --project tsconfig.build.json --remove --copyfiles --watch --exec bootstrap.js

License

MIT