Search docs/

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

Permission errors are common on macOS when installing global packages with npm. If you get an EACCES error, see Resolving Permission Errors.


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:

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 is a command-line utility, but there are many GUI clients available. GitHub Desktop is recommended, and works well with GitHub.

Packages & CDN
iOS Setup