2019-04-22 12:13:15 +01:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								# Opting into Angular Ivy
  
						 
					
						
							
								
									
										
										
										
											2019-02-06 15:32:32 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2019-03-25 09:47:47 -07: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 15:32:32 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2019-04-22 12:13:15 +01:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								## Using Ivy in a new project
  
						 
					
						
							
								
									
										
										
										
											2019-02-06 15:32:32 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2019-02-27 17:26:10 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								To start a new project with Ivy enabled, use the `--enable-ivy`  flag with the [`ng new` ](cli/new ) command:
							 
						 
					
						
							
								
									
										
										
										
											2019-02-06 15:32:32 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								```sh
							 
						 
					
						
							
								
									
										
										
										
											2019-02-27 17:26:10 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								ng new shiny-ivy-app --enable-ivy
							 
						 
					
						
							
								
									
										
										
										
											2019-02-06 15:32:32 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								```
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2019-04-22 12:13:15 +01:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								The new project is automatically configured for Ivy. Specifically, the enableIvy option is set to `true`  in the project's `tsconfig.app.json`  file.
							 
						 
					
						
							
								
									
										
										
										
											2019-02-06 15:32:32 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2019-04-22 12:13:15 +01:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								## Using Ivy in an existing project
  
						 
					
						
							
								
									
										
										
										
											2019-02-06 15:32:32 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2019-04-19 18:04:34 +01:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								To update an existing project to use Ivy, set the `enableIvy`  option in the `angularCompilerOptions`  in your project's `tsconfig.app.json` .
							 
						 
					
						
							
								
									
										
										
										
											2019-02-06 15:32:32 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								```json
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								{
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								  "compilerOptions": { ... },
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								  "angularCompilerOptions": {
							 
						 
					
						
							
								
									
										
										
										
											2019-03-25 16:19:17 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								    "enableIvy": true
							 
						 
					
						
							
								
									
										
										
										
											2019-02-06 15:32:32 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								  }
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								}
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								```
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2019-04-19 18:04:34 +01:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								To stop using the Ivy compiler, set `enableIvy`  to `false`  in `tsconfig.app.json` , or remove it completely.