Atco

The tool that provide powerful additional options for Typescript Compiler

Requirements

nodejs >= v12.16.0
npm >= v6.14.0 (or yarn >= v1.22.0)

Installation

using npm

npm install --save-dev typescript atco

Or using yarn

yarn add --dev typescript atco

Usage

Navigate to project root
Create tsconfig.json, inside it you have to specific the output directory using compilerOptions.outDir and specific the target directory using include, like the following example

{
  "compilerOptions": {
    "outDir": "./dist"  
  },
  "include": ["./src/**/*"]
}

In package.json add these two scripts

{
  "scripts": {
    "start:dev": "atco -w --exec \"node ./dist/index.js\"",
    "start:prod": "atco && node ./dist/index.js"
  }
}

To start app in development mode run the following command

# Using npm
npm start:dev
# Or using yarn
yarn start:dev

Or start it in production mode using

# Using npm
npm start:prod
# Or using yarn
yarn start:prod

Examples

atco-simple-example

The Additional Options (API)

AdditionalOption	Type	Default	Description
`--copyOthers`	boolean	true	Copy files (which doesn't end with extension `.js` or `.ts`) and directories (which doesn't contain any file end with extension `.js` or `.ts`)
`--cleanOutDir`	boolean	true	Remove all files and directories in output directory before start running
`--exec`	string		Execute the given command when compiling (and copying if `--copyOthers` set to `true`) done successfully

NOTE: if output directory not exists atco will automatically create it, the puropse of --cleanOutDir is clean the output directory if it was exists

The other options except (--project, -p, --version,--help) will be forward to Typescript Compiler (take a look at typescript compiler options)

Known Problems

The following problems is currently happening however we will try to fix it in the future

In watch mode atco doesn't track remove event (so if you remove file or directory you have to rerun command)