Community Maintenanceβ
The Ionic Framework has been 100% open source (MIT) since the very beginning, and always will be. Developers can ensure Ionic is the right choice for their cross-platform apps through Ionicβs community maintenance strategy. The Ionic team regularly ships new releases, bug fixes, and is very welcoming to community pull requests.
Framework Maintenance and Support Statusβ
Given the reality of time and resource constraints as well as the desire to keep innovating in the frontend development space, over time it becomes necessary for the Ionic team to shift focus to newer versions of the Framework. However, Ionic will do everything it can to make the transition to newer versions as smooth as possible. The Ionic team recommends updating to the newest version of the Ionic Framework for the latest features, improvements and stability updates. For more details, consult the Migration page.
The current status of each Ionic Framework version is:
| Version | Status | Released | Maintenance Ends | Ext. Support Ends |
|---|
| V6 | Active | Dec 8, 2021 | TBD | TBD |
| V5 | Maintenance | Feb 11, 2020 | June 8, 2022 | Dec 8, 2022 |
| V4 | Extended Support Only | Jan 23, 2019 | Aug 11, 2020 | Sept 30, 2022 |
| V3 | End of Support | Apr 5, 2017 | Oct 30, 2019 | Aug 11, 2020 |
| V2 | End of Support | Jan 25, 2017 | Apr 5, 2017 | Apr 5, 2017 |
| V1 | End of Support | May 12, 2015 | Jan 25, 2017 | Jan 25, 2017 |
- Maintenance: Only critical bug and security fixes. No major feature improvements.
- Extended Support: For teams and organizations that require additional long term support, Ionic has extended support options available. To learn more, see our Enterprise offerings.
The Ionic team has compiled a set of recommendations for using the Ionic Framework in conjunction with other contextually-relevant software. This is not meant to be a comprehensive list, but covers many common compatibility questions. The Ionic team strongly recommends reviewing your project dependencies once each quarter to keep track of new releases, features and bug fixes.
| Framework | Minimum Angular Version | Maximum Angular Version | TypeScript |
|---|
| v6 | v12 | v14.x^ | 4.0+ |
| v5 | v8.2 | v12.x | 3.5+ |
| v4 | v8.2 | v11.x | 3.5+ |
| v3 | v5.2.11 | v5.2.11 | 2.6.2 |
^ Angular 14.x support was added in Ionic v6.1.9.
| Framework | Required React Version | TypeScript |
|---|
| v6 | v17+ | 3.7+ |
| v5 | v16.8+ | 3.7+ |
| v4 | v16.8+ | 3.7+ |
| Framework | Required Vue Version | TypeScript |
|---|
| v6 | v3.0.6+ | 3.9+ |
| v5 | v3.0+ | 3.9+ |
| Framework | Cordova | Capacitor |
|---|
| V5 - Angular | cordova-android 8.X, cordova-ios 5.X | Latest 2.X |
| V5 - React | Not supported | Latest 2.x |
| V5 - Vue | Not supported | Latest 2.X |
| V4 - Angular | cordova-android 8.X, cordova-ios 5.X | Latest 2.X |
| V4 - React | Not supported | Latest 2.x |
| V3 | cordova-android 8.X, cordova-ios 5.X | Not officially supported |
- As iOS and Android (and related tools) are updated, you can expect more updates for Cordova and Capacitor, so it is recommended to stay on the latest version(s) of Cordova and Capacitor.
| Framework | Appflow | Ionic Native Premier Plugins* |
|---|
| V5 - Angular | @ionic/angular 5.X | Use latest available |
| V5 - React | @ionic/react 5.X | Use latest available |
| V4 - Angular | @ionic/angular 4.X | Use latest available |
| V4 - React | @ionic/react 4.X | Use latest available |
| V3 | ionic-angular 3.9.X | Use latest; special configuration may be required |
| Framework | Ionic Studio | Ionic Native Community Plugins* |
|---|
| V5 - Angular | @ionic/angular 5.X | @awesome-cordova-plugins 5.X |
| V5 - React | Not currently supported | @awesome-cordova-plugins 5.X* |
| V4 - Angular | @ionic/angular 5.X | @awesome-cordova-plugins 5.X |
| V4 - React | Not currently supported | @awesome-cordova-plugins 5.X* |
| V3 | Not currently supported | @awesome-cordova-plugins 4.X |
- Wrappers (and their associated plugins) are community maintained.
- *Cordova plugin support with Ionic Native and
@ionic/react can be achieved using the vanilla JavaScript implementation