# mtsc
> Monorepo solution for multiple typescript projects. Watch multiple typescript compilers concurrently at the same time, without losing output!
Latest version **4.0.0-no-tslint** (published 2020-11-16) · Apache-2.0 license · 0 weekly downloads
## Install
```sh
npm install mtsc
pnpm add mtsc
yarn add mtsc
bun add mtsc
```
Provides the command `mtsc`.
## Health
**Score 15/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 4.0.0-no-tslint |
| Published | 2020-11-16 |
| First published | 2017-08-27 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 45.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 18 |
| Author | guidsdo |
| Maintainers | guidojo |
| Keywords | mono, repo, monorepo, multiple, typescript, projects, compilers, compilations, concurrent, vscode, tasks, tsc |
## Links
- npm: https://www.npmjs.com/package/mtsc
- Repository: https://github.com/guidsdo/multipleTypescriptCompilers
- Homepage: https://github.com/guidsdo/multipleTypescriptCompilers#readme
- Issues: https://github.com/guidsdo/multipleTypescriptCompilers/issues
- npm.io page: https://npm.io/package/mtsc
## Dependencies (4)
- [colors](https://npm.io/package/colors.md) ^1.4.0
- [moment](https://npm.io/package/moment.md) ^2.29.1
- [shelljs](https://npm.io/package/shelljs.md) ^0.8.4
- [commander](https://npm.io/package/commander.md) ^6.2.0
## Alternatives
- [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads
- [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads
- [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads
- [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads
- [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads
## Recent versions
- 4.0.0-no-tslint (latest) — 2020-11-16
- 4.0.0-dependency-beta (beta) — 2021-12-05
- 4.0.0 (4.0.0-dependency-test) — 2021-12-05
- 3.3.1 — 2020-11-11
- 3.3.0 — 2019-10-18
- 3.2.0 — 2019-01-16
- 3.1.1 — 2019-01-15
- 3.1.0 — 2019-01-11
- 3.0.0 — 2018-11-29
- 2.1.0 — 2018-09-21
- 2.0.1 — 2018-06-22
- 2.0.0 — 2018-05-29
- 1.2.4 — 2018-04-16
- 1.2.3 — 2018-04-06
- 1.2.2 — 2018-04-06
- … 21 more at https://npm.io/package/mtsc/versions
## README
# Multiple Typescript Compilers 
_Monorepo solution for multiple typescript projects. Watch multiple typescript compilers concurrently at the same time, without losing output!_
[](https://travis-ci.org/guidsdo/multipleTypescriptCompilers)
[](https://coveralls.io/github/guidsdo/multipleTypescriptCompilers?branch=master)
[](https://snyk.io/test/github/guidsdo/multipleTypescriptCompilers)
[](https://david-dm.org/guidsdo/multipleTypescriptCompilers)
[](https://www.npmjs.com/package/mtsc)
[](https://www.npmjs.com/package/mtsc)
[](https://github.com/prettier/prettier)
## Update 18-november-2020
Currently this library is in the process of removing tslint support. For some reasons, tslint is deprecated and this means that you will have to move to eslint for linting. I haven't found a good upgrade path for mono-repositories yet. When one is found, I'll update Mtsc with it. The whole goal of Mtsc is to integrate into vscode (since it has terrible multi-project support). Vscode team 'fixed' this partly with workspaces, but in practise this isn't a full fix and it also makes your dev environment feels like a complete mess.
The vision and goal for Mtsc is, and always has been, the following:
- Be able to lint and ts-compile multiple projects, concurrently whilst keeping all the results (not possible with just `concurrently`)
- Facilitate proper vscode integration which means:
- See lint and tsc result without having to open a specific file
- Require the least amount of necessary configurability
- Support mono-repo's natively
- Support the following workflow:
1. Clone a project
1. `yarn`
1. `code .`
1. `cmd+shift+b`
1. See what's happening in your whole monorepo and be able to work at the same time (watchmode). :mindblown:
To be honest, I'm not optimistic because it seems that I will have to do a lot of work to make this work for ts-eslint (which itself already feels like a hack). But hey, on the other hand; I love diving in this kind of stuff.
**For now, please use the latest version with the `-no-tslint` tag.**
## Usage
**NOTE: Supported versions: Typescript 2.8+. Use Mtsc 1.\* for older versions**
### Cli:
`mtsc [directories/tsconfigs...]`
### Examples:
`./node_modules/.bin/mtsc client scripts/ide.tsconfig.json special/location`
`mtsc client scripts/ide.tsconfig.json special/location -w`
`mtsc -c client/tsconfig.json scripts/ide.tsconfig.json -w`
`mtsc -c node_modules/.bin/tsc client/tsconfig.json scripts/ide.tsconfig.json -w`
## Why?
I began this project because vscode can't handle the output of multiple typescript projects. If you have multiple projects watched at the same time, only the output of the last compilation will be considered and the other errors of other projects are hidden. This has to do, with the problem matcher vscode uses, explained here: https://code.visualstudio.com/docs/editor/tasks-v1#_background-watching-tasks
### How it was fixed:
This always prints the compilation output of the other projects when a new compilation is done. It also makes sure that the interpreter knows there is still a compilation going on by printing a compilation start message when there is still one running.
### Known issues
This package has a peerdependency on tslint. The tool allows you to not use tslint, but will fail if tslint cannot be found. Currently nobody has complained about it (or anything for that matter) so it won't be fixed. Most serious typescript projects have tslint anyway.
## Cli
```
Usage: mtsc [options] [projects/tsconfigs...]
Options:
-d, --debug Add way too much logging
-c, --config [path_to_config] Path to mtsc config
-w, --watch Watch the given projects (default false)
-t, --tsc [path_to_tsc] Path to compiler for all projects (will search in exec dir if not given)
-l, --lint [path_to_tslintrules] Path to tslint rules for all projects (will search if not given)
--noEmit Do not emit outputs
--tslintAlwaysShowAsWarning Always show tslint output as warning
-h, --help output usage information
```
## mtsc.json spec
[Config spec can be seen here](https://github.com/guidsdo/multipleTypescriptCompilers/blob/master/src/config/configSpec.ts)
## Vscode integration
Set the typescript compiler in vscode by clicking on the compiler version. This is only possible when you open a typescript file. This setting sometimes goes to the builtin vscode compiler, so if you don't see errors; check this first.
## Tslint support
Install the right plugin and follow the README: https://github.com/Microsoft/typescript-tslint-plugin
[Tslint section of config spec here](https://github.com/guidsdo/multipleTypescriptCompilers/blob/master/src/config/configSpec.ts)
## Vscode tasks json examples
### Example using cli only
```json
{
"version": "2.0.0",
"tasks": [
{
"type": "shell",
"label": "Mtsc",
"command": "./node_modules/.bin/mtsc -w projectA scripts/projectB projectC/tsconfig.json",
"isBackground": true,
"problemMatcher": "$tsc-watch",
"group": {
"kind": "build",
"isDefault": true
},
"runOptions": {
"runOn": "folderOpen"
}
}
]
}
```
### Example using CLI + config
`tasks.json`
```json
{
"version": "2.0.0",
"tasks": [
{
"type": "shell",
"label": "Mtsc",
"command": "./node_modules/.bin/mtsc",
"isBackground": true,
"problemMatcher": "$tsc-watch",
"group": {
"kind": "build",
"isDefault": true
},
"runOptions": {
"runOn": "folderOpen"
}
}
]
}
```
`mtsc.json` (will be autodetected)
```json
{
"debug": false,
"watch": true,
"projects": ["projectA", "scripts/projectB", "projectC/tsconfig.json"]
}
```
## Roadmap
- Allow directories to be ignored, because tslint doesn't always pick them up unfortunately.
- Any ideas? Let me know :)
---
**Mtsc is proudly used for development at [Mendix](https://www.mendix.com)**
---
_Source: https://npm.io/package/mtsc · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._