Skip to content

support.md

Latest commit

 

History

History
116 lines (86 loc) · 7.35 KB

support.md

File metadata and controls

116 lines (86 loc) · 7.35 KB
title Support Policy
<title>App Development Support Policy - Ionic Framework API</title>

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.

The current status of each Ionic Framework version is:

Version Status Released Maintenance Ends Ext. Support Ends
V7 Extended Support Mar 29, 2023 Oct 17, 2024 Apr 17, 2025
V6 End of Support Dec 8, 2021 Sep 29, 2023 Mar 29, 2024
V5 End of Support Feb 11, 2020 June 8, 2022 Dec 8, 2022
V4 End of Support 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 maintenance support, Ionic has extended support options available. To learn more, see our Enterprise offerings.

Compatibility Recommendations

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.

Core Dependencies

Ionic Angular

Framework Minimum Angular Version Maximum Angular Version TypeScript
v7 v14 v17.x1 4.6+
v6 v12 v15.x2 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 13+ Support On Older Versions of iOS

Angular's support policy for iOS is the two most recent major versions. This means that changes to your Angular project may be necessary to use Ionic Angular v4-v6 on iOS 13. To support iOS 13, change the project target specified in compilerOptions in the tsconfig.json to es5. Without this change an error of Unexpected token '.' in promiseReactionJob will occur on app startup in iOS 13.

Note that later versions of Ionic do not support iOS 13; see mobile support table here.

Ionic React

Framework Required React Version TypeScript
v7 v17+ 3.7+
v6 v17+ 3.7+
v5 v16.8+ 3.7+
v4 v16.8+ 3.7+

Ionic Vue

Framework Required Vue Version TypeScript
v7 v3.0.6+ 3.9+
v6 v3.0.6+ 3.9+
v5 v3.0+ 3.9+

Native Bridges

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.

Ionic Platform & Products

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

Ionic Platform & Products (Cont.)

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

Footnotes

  1. Angular 17.x supported starting in Ionic v7.5.4. ↩

  2. Angular 14.x supported starting in Ionic v6.1.9. Angular 15.x supported starting in Ionic v6.3.6. ↩