ionic start
Create a new project
$ ionic start [options]
This command creates a working Ionic app. It installs dependencies for you and sets up your project.
Running ionic start
without any arguments will prompt you for information about your new project.
The first argument is your app's name
. Don't worry--you can always change this later. The --project-id
is generated from name
unless explicitly specified.
The second argument is the template
from which to generate your app. You can list all templates with the --list
option. You can also specify a git repository URL for template
, in which case the existing project will be cloned.
Use the --type
option to start projects using older versions of Ionic. For example, you can start an Ionic 3 project with --type=ionic-angular
. Use --list
to see all project types and templates.
Examples
$ ionic start
$ ionic start --list
$ ionic start myApp
$ ionic start myApp blank
$ ionic start myApp tabs --cordova
$ ionic start myApp tabs --capacitor
$ ionic start myApp super --type=ionic-angular
$ ionic start myApp blank --type=ionic1
$ ionic start cordovaApp tabs --cordova
$ ionic start "My App" blank
$ ionic start "Conference App" https://github.com/ionic-team/ionic-conference-app
Inputs
name | |
---|---|
Description | The name of your new project (e.g. |
template | |
Description | The starter template to use (e.g. |
Options
--list | |
---|---|
Description | List available starter templates |
Aliases | -l |
--type =<type> | |
Description | Type of project to start (e.g. |
--cordova | |
Description | Include Cordova integration |
--capacitor | |
Description | Include Capacitor integration |
--id =<id> | |
Description | Specify an Ionic App ID to link |
Advanced Options
--no-deps | |
---|---|
Description | Do not install npm/yarn dependencies |
--no-git | |
Description | Do not initialize a git repo |
--link | |
Description | Connect your new app to Ionic |
--project-id =<slug> | |
Description | Specify a slug for your app (used for the directory name and package name) |
--package-id =<id> | |
Description | Specify the bundle ID/application ID for your app (reverse-DNS notation) |