All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

• enterprise: add shortcut for registering (a1890b4)
• add i as alias for integrations (14a7ddb)
• integrations: add --web-dir option for capacitor integration (#3895) (8a1c4b2)
• integrations: ionic enterprise integration (#3905) (b071fcb)

• cordova: add experimental --cordova-res flag (16cdef8)
• cordova: add experimental --native-run flag (a80d465)

Note: Version bump only for package ionic

Note: Version bump only for package ionic

• angular: pass --project and --configuration for custom scripts (2cf724f)

• cordova: only forward correct options (817879b)

• ionic-angular: link to proper v3 docs (a89c097)

• serve: add DevApp support for Ionic 4 projects (#3830) (6edf373)

• custom: run ionic:build/ionic:serve scripts (9898fa8)
• resources: --cordova-res option for local resource generation (3c27e05)
• start: make Ionic 4 the default for new projects (#3820) (0195f96)

• appflow: command to create deploy builds (#3815) (d346e03)

Note: Version bump only for package ionic

• doctor: handle multilines for viewport-fit-not-set (#3809) (6aa7ae6)
• executor: Exclude options for command argument parsing (#3798) (514015f)
• serve: handle error in opn with debug statement (89b6d33)

• appflow: command to create package builds (#3808) (149f06e)
• cordova: auto-forward port when using --native-run (0da50ac)

• cordova: warn for prepare w/o platforms (385bdf2)

• serve: collapse numbered chunk output and summarize (5ac6834)
• start: update for Ionic Framework 4.0 RC (7e943cc)

• cordova: do not error for ctrl+c during livereload (facc96b)
• serve: ignore link-local addresses (#3761) (1b7fd90)
• telemetry: disable automatically for CI (217ca12)

• Ionic Appflow rebranding (16360af)
• cordova: add --native-run option to Cordova run (#3757) (9ef53ad)

• multi-app: properly handle bare projects (3f84a6f), closes /github.com/ionic-team/ionic-docs/issues/83#issuecomment-439655706
• project: write determined project type to config (307d81f)

• build: show build progress (3090615)
• help: show value hint for options (aa13ba8)
• init: add ionic init command (4a12b17)
• login: SSO authentication flow (#3741) (71b319a)
• serve: forward --ssl to Angular CLI (815b49a)

• bin: stringify unresolved promise event (788a5ec)
• bootstrap: supply env for CLI <4.3.0 (78dbda8)
• multi-app: hide project warnings during start (b1ecd77)
• start: fix stdio freezing issue on Windows (#3725) (a570770)

• capacitor: switch off livereload for --no-build (9960047)
• help: filter out unnecessary global options (7809c99)
• ssh: adjust validator to work for OpenSSH 7.8 (dcc598a)
• terminal: adjust some feature detection on windows (8a2ed99)

• capacitor: add --livereload-url option for custom dev server (b7738f5)
• cordova: add --livereload-url option for custom dev server (ad57e36)
• integrations: --root option for choosing an alternative location (7e8f11e)
• multi-app: determine active project via cwd path match (f83dc5b)
• resources: generate resources without needing platform installation (4f20554)
• start: better multi-app support (3c70e87)

• doctor: fix viewport-fit-not-set for ionic1 (826b9ae)
• info: show versions for @ionic/angular-toolkit (9d1824a)

• cordova: ng should ignore separated args for Cordova build (16a0111)
• lab: use correct query params for project type (4801680)
• serve: fix incorrect message about app-scripts not being installed (abd665b)
• serve: unnecessary message about utility CLI exiting during Ctrl+C (8e78bf3)

• new ionic repair command (7588233)

• capacitor: use integration root for Capacitor CLI (81a45d5)

• cordova: respect --nosave for platform/plugin add (eb4934b)
• deploy: exclude any existing pro-manifest.json files (#3527) (d03057d)
• shell: allow output() to fail with original error (e6a5bff)
• shell: check if process is still alive before sending signal (0ff1e48)

• capacitor: pass in project/package id during start (1357c5c)
• cordova: properly error for multiple IPs with non-interactive mode (0346adc)
• cordova: remove unwanted allow-navigation entries (77984e1)
• info: disable update check for cordova cli (8310ff6)
• info: remove version.json warning for v1 (78c3582)
• link: support new repo association types (1c1e1f1)

• capacitor: add run command (62a2918)
• capacitor: document platform argument, prompt when required (2a312ab)
• capacitor: install platform if missing (9e29235)
• capacitor: prompt for supported platforms when adding (54c7d55)
• capacitor: unlock capacitor commands as beta (2480a01)
• info: print whitelisted cordova plugins (c266b7b)

• serve: fix unclosed connection issue again (#3500) (1f0ef3b)

Note: Version bump only for package ionic

• serve: properly cleanup child processes (#3481) (38217bf)

• build: prompt to install "build cli" for all projects (2862762)
• serve: await connectivity on specified host, not localhost (#3444) (bf10674)
• serve: check all network interfaces for an available port (30fd6ef)
• serve: fix --livereload for device/emulator (f31e79d)
• serve: use correct livereload port option for v1 (bf3e775)

• cordova: default to cordova prepare without platforms (d40d961)
• resources: fix hanging issue (#3429) (6b7c732)
• build: properly pass --target to remove fonts for cordova (530d87a)
• generate: run in current directory (54c632b)
• info: filter out hidden files/folders (2e56dd7)
• info: show 'not available' when cordova is missing (db60879)

• generate: remove pages/ prefix recommendation (#3392) (23d0db6)
• help: properly show option decorations (b2509de)

Note: Version bump only for package ionic

This release offers support for ✨ Ionic 4 ✨ (beta).

📝 Use the new CLI Documentation on the beta framework documentation website for CLI 4.

Aside from a few edge cases listed below, upgrading to CLI 4 should be seamless.

Ionic 2/3: The CLI will continue working with apps using @ionic/app-scripts for tooling (please update to the latest version to avoid any issues). The CLI will continue to support projects that have yet to migrate to Ionic 4 w/ Angular CLI for tooling. For those who wish to migrate v3 apps to v4, see the Migration Guide.

Ionic 1: For Ionic 1 projects, a new toolkit has been introduced to slim down the main CLI package. All functionality is still supported, but the @ionic/v1-toolkit package needs to be installed.

• Support for legacy Ionic Cloud ended on January 31st, 2018. The ionic upload and ionic package commands have been removed from the CLI. Support for Ionic Appflow will be a major focus for the CLI going forward. 👌
• The app_id property in ionic.config.json has been renamed to pro_id and is now optional (see #3038). The CLI automatically detects this and changes it, but this notice is here if your build scripts rely on the setting.
• ionic build will no longer run cordova prepare. Instead, run ionic cordova prepare <platform>, which performs an Ionic build beforehand.
• ionic cordova prepare will no longer run an Ionic build without a platform, e.g. ionic cordova prepare ios (see #3653)
• Ionic Lab has been moved into the @ionic/lab package, which will need to be installed for Lab to work.
• The conference starter template has been removed from ionic start. To clone existing apps (as opposed to starting new apps from starter templates), please use the app's repository URL. For example, to create the conference app, use ionic start "Conference App" https://github.com/ionic-team/ionic-conference-app.
• The --display-name option for ionic start has been removed. The name argument is now used as the display name and slugified for directory name, package name, etc. To provide a custom slug, use --project-id (see #3038).
• The ionic:watch:before npm script hook has been renamed to ionic:serve:before, but behaves the same.
• ionic doctor check will now only print issues and exit with exit code 1 if issues are found. Use ionic doctor treat to attempt automatic fixes.
• ionic doctor ignore has been removed in favor of ionic config set -g doctor.issues.<issue>.ignored true).
• Ionic 1 build/serve functionality has been moved into the @ionic/v1-toolkit package, which will need to be installed in your Ionic 1 project(s). The file watcher, chokidar, has been updated to 2.0.0, which will require those using watchPatterns to always use POSIX-style slashes (not an issue if you've never used a backslash in globs for Windows).
• The gulp integration has been removed from the CLI and put into the @ionic/v1-toolkit package, which is only for Ionic v1 apps.

• ionic s is now an alias for ionic serve.
• No need for @ionic/cli-plugin-proxy. Proxy support is now built-in. Use existing environment variables or use ionic config set -g proxy <url>.
• New ionic config unset command for deleting config values.
• New ionic doctor treat command that attempts automatic fixes of detected issues.
• If ionic:build or ionic:serve npm scripts are defined in your package.json, the Ionic CLI will use them for the Ionic build/serve instead of the default for your project type.
• Automatic login via IONIC_TOKEN environment variable #2410
• --no-color flag for turning off CLI colors
• --no-build option for ionic cordova run and ionic cordova emulate #2930
• Better monorepo support. See the discussion in #2232.
• Multi-app support for new Angular projects #3281
• Added experimental ionic ssl generate command for generating localhost SSL certificates for use with ionic serve. 📝 HTTPS support in ionic serve isn't quite finished yet (see #3305).

• Interactivity is now disabled when not in a TTY. See #3047.
• Respect --nosave flag for ionic cordova platform and ionic cordova plugin #2946
• Chain --verbose flag to Cordova for ionic cordova commands #2919
• Fixed newlines in piped output from underlying CLIs.

• A huge amount of code refactoring has been accomplished to prepare the CLI for a scalable, flexible future. Changes in behavior and help output based upon environment and config are now trivially accomplished.
• The CLI Framework, a (currently) internal framework for building general-purpose command-line programs, has had many features added to support the utility CLIs such as ionic-lab and ionic-v1.
• Ionic Lab has been rebuilt using StencilJS and now works for any Ionic Framework version.

• 3.x CHANGELOG.md
• 1.x-2.x CHANGELOG.md