2021-12-10 17:00:25 -05:00
<p align="center">
<a href="#">
2021-12-13 13:34:12 -05:00
<img alt="Ionic" src="https://github.com/ionic-team/ionic-framework/blob/main/.github/assets/logo.png?raw=true" width="60" />
2021-12-10 17:00:25 -05:00
</a>
</p>
<h1 align="center">
Ionic
</h1>
<p align="center">
Ionic is an open source app development toolkit for building modern, fast, top-quality cross-platform native and Progressive Web Apps from a single codebase with JavaScript and the Web.
</p>
<p align="center">
Ionic is based on <a href="https://www.webcomponents.org/introduction">Web Components</a>, which enables significant performance, usability, and feature improvements alongside support for popular web frameworks like <a href="https://angular.io/">Angular</a>, <a href="https://reactjs.com/">React</a>, and <a href="https://vuejs.org/">Vue</a>.
</p>
<p align="center">
<a href="https://github.com/ionic-team/ionic-framework/blob/main/LICENSE">
<img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="Ionic Framework is released under the MIT license." />
</a>
2024-05-15 17:26:27 -04:00
<a href="https://github.com/ionic-team/ionic-framework/blob/main/docs/CONTRIBUTING.md">
2021-12-10 17:00:25 -05:00
<img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs welcome!" />
</a>
<a href="https://twitter.com/Ionicframework">
<img src="https://img.shields.io/twitter/follow/ionicframework.svg?label=Follow%20@IonicFramework " alt="Follow @IonicFramework ">
</a>
<a href="https://ionic.link/discord">
<img src="https://img.shields.io/discord/520266681499779082?color=7289DA&label=%23ionic&logo=discord&logoColor=white" alt="Official Ionic Discord" />
</a>
</p>
<h2 align="center">
2023-03-17 15:55:18 -04:00
<a href="https://ionicframework.com/docs/intro/cli">Quickstart</a>
2021-12-10 17:00:25 -05:00
<span> · </span>
<a href="https://ionicframework.com/docs/">
Documentation
</a>
<span> · </span>
2024-05-15 17:26:27 -04:00
<a href="https://github.com/ionic-team/ionic-framework/blob/main/docs/CONTRIBUTING.md">Contribute</a>
2021-12-10 17:00:25 -05:00
<span> · </span>
<a href="https://blog.ionicframework.com/">Blog</a>
<br />
2023-03-23 14:46:57 -04:00
Community:
2021-12-10 17:00:25 -05:00
<a href="https://ionic.link/discord">Discord</a>
<span> · </span>
<a href="https://forum.ionicframework.com/">Forums</a>
<span> · </span>
<a href="https://twitter.com/Ionicframework">Twitter</a>
</h2>
2017-07-06 16:11:52 -04:00
2018-10-29 15:10:29 -05:00
### Packages
2017-07-06 16:11:52 -04:00
2021-12-10 17:00:25 -05:00
| Project | Package | Version | Downloads| Links |
| ------- | ------- | ------- | -------- |:-----:|
| **Core ** | [`@ionic/core` ](https://www.npmjs.com/package/@ionic/core ) | [](https://www.npmjs.com/package/@ionic/core ) | <a href="https://www.npmjs.com/package/@ionic/core " target="_blank"><img src="https://img.shields.io/npm/dm/@ionic/core .svg" alt="NPM Downloads" /></a> | [`README.md` ](core/README.md )
2023-08-22 22:14:24 +08:00
| **Angular ** | [`@ionic/angular` ](https://www.npmjs.com/package/@ionic/angular ) | [](https://www.npmjs.com/package/@ionic/angular ) | <a href="https://www.npmjs.com/package/@ionic/angular " target="_blank"><img src="https://img.shields.io/npm/dm/@ionic/angular .svg" alt="NPM Downloads" /></a> | [`README.md` ](packages/angular/README.md )
2021-12-10 17:00:25 -05:00
| **Vue ** | [`@ionic/vue` ](https://www.npmjs.com/package/@ionic/vue ) | [](https://www.npmjs.com/package/@ionic/vue ) | <a href="https://www.npmjs.com/package/@ionic/vue " target="_blank"><img src="https://img.shields.io/npm/dm/@ionic/vue .svg" alt="NPM Downloads" /></a> | [`README.md` ](packages/vue/README.md )
| **React ** | [`@ionic/react` ](https://www.npmjs.com/package/@ionic/react ) | [](https://www.npmjs.com/package/@ionic/react ) | <a href="https://www.npmjs.com/package/@ionic/react " target="_blank"><img src="https://img.shields.io/npm/dm/@ionic/react .svg" alt="NPM Downloads" /></a> |[`README.md` ](packages/react/README.md )
2017-07-06 16:11:52 -04:00
2018-10-29 15:10:29 -05:00
Looking for the `ionic-angular` package? Ionic 3 has been moved to the [`ionic-v3` ](https://github.com/ionic-team/ionic-v3 ) repo. See [Earlier Versions ](#earlier-versions ).
2017-07-06 16:11:52 -04:00
2017-07-21 12:15:12 -04:00
### Getting Started
2017-07-06 16:11:52 -04:00
2024-05-15 17:26:27 -04:00
Start a new project by following our [documentation ](https://ionicframework.com/docs/ ).
2017-07-21 12:15:12 -04:00
We would love to hear from you! If you have any feedback or run into issues using our framework, please file
2024-05-15 17:26:27 -04:00
an [issue ](https://github.com/ionic-team/ionic-framework/issues/new ) on this repository.
2017-07-06 16:11:52 -04:00
2021-12-10 17:00:25 -05:00
### Migration Guides
Already have an Ionic app? These guides will help you migrate to the latest versions.
2024-05-15 17:26:27 -04:00
* [Migrate from v7 to v8 ](https://ionicframework.com/docs/updating/8-0 )
2023-03-31 10:34:26 -04:00
* [Migrate from v6 to v7 ](https://ionicframework.com/docs/updating/7-0 )
* [Migrate from v5 to v6 ](https://ionicframework.com/docs/updating/6-0 )
* [Migrate from v4 to v5 ](https://ionicframework.com/docs/updating/5-0 )
* [Migrate from v3 to v4 ](https://ionicframework.com/docs/updating/4-0 )
2021-12-10 17:00:25 -05:00
### Examples
2023-03-23 14:46:57 -04:00
The Ionic Conference App is a full featured Ionic app. It is the perfect starting point for learning and building your own app.
- [Angular Ionic Conference App ](https://github.com/ionic-team/ionic-conference-app )
- [React Ionic Conference App ](https://github.com/ionic-team/ionic-react-conference-app )
2024-05-15 17:26:27 -04:00
- [Vue Ionic Conference App ](https://github.com/ionic-team/ionic-vue-conference-app )
2017-07-06 16:11:52 -04:00
2017-07-21 12:15:12 -04:00
### Contributing
2017-07-06 16:11:52 -04:00
2017-07-21 12:15:12 -04:00
Thanks for your interest in contributing! Read up on our guidelines for
2024-05-15 17:26:27 -04:00
[contributing ](https://github.com/ionic-team/ionic-framework/blob/main/docs/CONTRIBUTING.md )
and then look through our issues with a [help wanted ](https://github.com/ionic-team/ionic-framework/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22 )
2017-07-21 12:15:12 -04:00
label.
2017-07-06 16:11:52 -04:00
2024-05-15 17:26:27 -04:00
Please note that this project is released with a [Contributor Code of Conduct ](https://github.com/ionic-team/ionic-framework/blob/main/CODE_OF_CONDUCT.md ). By participating in this project you agree to abide by its terms.
2017-07-06 16:11:52 -04:00
2018-10-29 15:10:29 -05:00
### Earlier Versions
2017-07-06 16:11:52 -04:00
2018-10-29 15:10:29 -05:00
The source code for earlier versions of the Ionic Framework may exist in other repositories. Please open issues and pull requests in their respective repositories.
2017-07-06 16:11:52 -04:00
2018-10-29 15:10:29 -05:00
* **Ionic 2/3**: Moved to [`ionic-team/ionic-v3` ](https://github.com/ionic-team/ionic-v3 )
* **Ionic 1**: Moved to [`ionic-team/ionic-v1` ](https://github.com/ionic-team/ionic-v1 )