Installation

Introduction to Ionic

Ionic is an open source UI toolkit for building performant, high-quality mobile apps using web technologies — HTML, CSS, and JavaScript — with integrations for popular frameworks like Angular, React, and Vue.

Get started building by installing Ionic or following our First App Tutorial to learn the main concepts.

Before proceeding, make sure your computer has Node.js installed. See these instructions to set up an environment for Ionic.

Install the Ionic CLI with npm:

$ npm install -g @ionic/cli

The -g option means install globally. When packages are installed globally, EACCES permission errors can occur.

Consider setting up npm to operate globally without elevated permissions. See Resolving Permission Errors for more information.

Environment Setup

To get started with Ionic Framework, the only requirement is a Node & npm environment.

Of course, a code editor is also required:

• Ionic Studio: the fastest and easiest way to build Ionic apps

• VS Code: a popular and free text editor made by Microsoft

Node & npm

Almost all tooling for modern JavaScript projects is based in Node.js. The download page has prebuilt installation packages for all platforms. We recommend selecting the LTS version to ensure best compatibility.

Node is bundled with npm, the package manager for JavaScript.

To verify the installation, open a new terminal window and run:

$ node --version
$ npm --version
$ ionic --version 

Make sure your project has the following setup when you run the above commands:

Node: v14.17.3
Npm: 6.14.13
Ionic: 6.20.3

Or you can locate ionic extension using vscode:

Select the ionic extension

After installation, Locate Recommendations in the extension and do exactly what is shown:

Although not required, the version control system Git is highly recommended.

Git is often accompanied by a Git Host, such as GitHub, in which case additional setup is required. Follow the tutorial from the Git Host's documentation to set up Git:

• GitHub: Set up Git

• GitLab: Installing Git

• Bitbucket: Install Git

Otherwise, follow the official installation instructions. The command-line utility can be downloaded from the download page.

To verify the installation, open a new terminal window and run:

$ git --version

Git GUI

Git is a command-line utility, but there are many GUI clients available. GitHub Desktop is recommended, and works well with GitHub.