New

ig new

Overview

ig new [name] creates a new Ignite UI application.

Using the new command, you can create a new Angular, React, Web Components or jQuery application. The application will be configured to use either Ignite UI for Angular, Ignite UI for React, Ignite UI for Web Components or Ignite UI for jQuery controls. The new application is created in a directory of the same name.

Note

Keep in mind that creating a new application inside an existing application is not supported.

Arguments

name

name (alias: -n)

The name of the application. The application is created inside a directory with the same name.

framework

--framework (alias: -f) default value: "jquery"

Framework to setup project for. The supported frameworks are Angular, React, jQuery and Web Components.

type

--type (alias: -t)

The available project types depend on the selected framework. Currently, Angular, React, Web Components and jQuery projects support a single type only - `igx-ts`, `igr-ts`, `igc-ts` and `js` respectively. As those are default project types, you do not need to provide `--type` argument explicitly.

theme

--theme (alias: -th)

Project theme (depends on project type).

skip-git

--skip-git (alias: --sg)

When this option is used, the automatic repository initialization with Git will be skipped. If the option is omitted, then the global skipGit configuration property is used.

skip-install (v4.0.0)

--skip-install (alias: --si)

Since v4.0.0 the ig new command will install package dependencies when the project is created. Passing this flag will skip the initial installation.

template (v3.0.0)

--template

Use this option if there are different project templates for a specific framework type. Currently this option is available only for Ignite UI for Angular igx-ts and Ignite UI for Web Components project types. The possible values are as it follows:

template id	template description
empty	Project structure with routing and a home page
side-nav	Project structure with side navigation drawer
side-nav-auth	Side navigation project extended with user authentication module (currently only available for Ignite UI for Angular)

Creating Ignite UI for Angular applications

To create an application that is configured to use the Ignite UI for Angular controls, you need to provide "igx-ts" as your project type argument.

Framework	Command
Angular	ig new newIgniteUIAngular --framework=angular --template=side-nav Using aliases: ig new newIgniteUIAngular -f=angular --template=side-nav

Note

After v13.1.0 the new command will generate Angular applications with standalone components by default. Legacy (NgModule based) applications are still supported by providing the --type=igx-ts-legacy flag.

Creating Ignite UI for React applications (v4.0.0)

To create an application that is configured to use the Ignite UI for React controls, you need to provide the desired framework (--framework=react). The following is an examples of how to use the new command to create an Ignite UI for React application:

Framework	Command
React	ig new newIgniteUIReact --framework=react Using aliases: ig new newIgniteUIReact -f=react

Creating Ignite UI for Web Components applications

To create an application that is configured to use the Ignite UI for Web Components controls, you need to you need to execute the following command:

Framework	Command
Web Components	ig new newIgniteUIWebComponents --framework=webcomponents Using aliases: ig new newIgniteUIAngular -f=webcomponents

Creating Ignite UI for jQuery applications

To create an application that is configured to use the Ignite UI for jQuery controls, you need to provide the desired framework (--framework=jquery) The following is an examples of how to use the new command to create an Ignite UI for jQuery application:

Framework	Command
jQuery	ig new newIgniteUIjQuery --framework=jquery Using aliases: ig new newIgniteUIjQuery -f=jquery