2019-02-06 10:32:32 -05:00
# Opting into Angular Ivy with Angular CLI
2019-03-25 12:47:47 -04:00
Ivy is the code name for Angular's [next-generation compilation and rendering pipeline ](https://blog.angular.io/a-plan-for-version-8-0-and-ivy-b3318dfc19f7 ). Starting with Angular version 8, you can choose to opt in to start using Ivy now, and help in its continuing develpment and tuning.
2019-02-06 10:32:32 -05:00
## Starting a new project using Ivy
2019-02-27 12:26:10 -05:00
To start a new project with Ivy enabled, use the `--enable-ivy` flag with the [`ng new` ](cli/new ) command:
2019-02-06 10:32:32 -05:00
```sh
2019-02-27 12:26:10 -05:00
ng new shiny-ivy-app --enable-ivy
2019-02-06 10:32:32 -05:00
```
2019-03-25 12:47:47 -04:00
The new project is automatically configured for Ivy.
2019-03-25 12:19:17 -04:00
- The `enableIvy` option is set to `true` in `tsconfig.app.json` .
2019-02-06 10:32:32 -05:00
{@a updating}
## Updating an existing project to use Ivy
2019-03-25 12:47:47 -04:00
You can update an existing project to use Ivy by making the following configuration changes.
2019-02-06 10:32:32 -05:00
2019-03-25 12:19:17 -04:00
- Add the `enableIvy` option in the `angularCompilerOptions` in your project's `tsconfig.app.json` .
2019-02-06 10:32:32 -05:00
```json
{
"compilerOptions": { ... },
"angularCompilerOptions": {
2019-03-25 12:19:17 -04:00
"enableIvy": true
2019-02-06 10:32:32 -05:00
}
}
```
## Switching back to the current compiler
To stop using the Ivy compiler you need to undo the steps taken when [updating to use Ivy ](#updating ).
2019-04-19 11:50:14 -04:00
- Set `enableIvy` to `false` in `tsconfig.app.json` , or remove it completely.