From cd074735b00db66d2d26136924709d647f695e69 Mon Sep 17 00:00:00 2001 From: Maria Hutt Date: Thu, 29 Oct 2026 11:35:00 -0700 Subject: [PATCH 1/4] docs(desktop): clarify that desktop usage is not officially supported --- docs/api/popover.mdx | 2 +- docs/core-concepts/fundamentals.mdx | 2 +- docs/reference/browser-support.mdx | 6 ++++++ versioned_docs/version-v8/api/popover.mdx | 2 +- versioned_docs/version-v8/core-concepts/fundamentals.mdx | 2 +- versioned_docs/version-v8/reference/browser-support.mdx | 6 ++++++ 6 files changed, 16 insertions(+), 4 deletions(-) diff --git a/docs/api/popover.mdx b/docs/api/popover.mdx index aad8fb1102..4d2453fa0d 100644 --- a/docs/api/popover.mdx +++ b/docs/api/popover.mdx @@ -212,7 +212,7 @@ type PositionAlign = 'start' | 'center' | 'end'; | Esc | Closes the popover. | | Space or Enter | Clicks the focusable element. | -`ion-popover` has full arrow key support for navigating between `ion-item` elements with the `button` property. The most common use case for this is as a dropdown menu in a desktop-focused application. In addition to the basic keyboard support, the following table details arrow key support for dropdown menus: +`ion-popover` has full arrow key support for navigating between `ion-item` elements with the `button` property. The most common use case for this is as a dropdown menu. In addition to the basic keyboard support, the following table details arrow key support for dropdown menus: | Key | Description | | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | diff --git a/docs/core-concepts/fundamentals.mdx b/docs/core-concepts/fundamentals.mdx index 7caac2fb8e..77bc04f9ee 100644 --- a/docs/core-concepts/fundamentals.mdx +++ b/docs/core-concepts/fundamentals.mdx @@ -36,7 +36,7 @@ For apps that are built with Angular and `@ionic/angular`, we recommend using th ## Native Access {/* #native-access */} -An amazing feature of apps built with web technologies (such as Ionic apps!) is that it can run on virtually any platform: desktop computers, phones, tablets, cars, refrigerators, and more! The same code base for Ionic apps can work on many platforms because it is based on web standards and common APIs that are shared across these platforms. +An amazing feature of apps built with web technologies (such as Ionic apps!) is that it can run on virtually any platform: desktop computers, phones, tablets, cars, refrigerators, and more! The same code base for Ionic apps can work on many platforms because it is based on web standards and common APIs that are shared across these platforms. That said, Ionic Framework is designed and tested for mobile platforms. Refer to [Browser Support](../reference/browser-support.mdx) for the platforms it officially supports. One of the most common use cases for Ionic is to build an app which can be downloaded from both the [App Store](https://www.apple.com/ios/app-store/) and [Play Store](https://play.google.com/). Both iOS and Android software development kits (SDKs) provide [Web Views](webview.mdx) which render any Ionic app, while still allowing for _full_ Native SDK access. diff --git a/docs/reference/browser-support.mdx b/docs/reference/browser-support.mdx index 5f0c5d38db..0e13491dd9 100644 --- a/docs/reference/browser-support.mdx +++ b/docs/reference/browser-support.mdx @@ -39,6 +39,12 @@ To figure out what version of the webview a device is running, log `window.navig ## Browsers {/* #browsers */} +:::note + +Ionic apps can run in desktop browsers, and nothing in Ionic Framework prevents it. However, Ionic is designed and tested for the mobile platforms listed above, so desktop usage is not officially supported. + +::: + Ionic supports the following browsers: | Browser | Ionic v9 | Ionic v8 | Ionic v7 | Ionic v6 | Ionic v5 | Ionic v4 | diff --git a/versioned_docs/version-v8/api/popover.mdx b/versioned_docs/version-v8/api/popover.mdx index 782fe7d0a0..416ec0aa0e 100644 --- a/versioned_docs/version-v8/api/popover.mdx +++ b/versioned_docs/version-v8/api/popover.mdx @@ -212,7 +212,7 @@ type PositionAlign = 'start' | 'center' | 'end'; | Esc | Closes the popover. | | Space or Enter | Clicks the focusable element. | -`ion-popover` has full arrow key support for navigating between `ion-item` elements with the `button` property. The most common use case for this is as a dropdown menu in a desktop-focused application. In addition to the basic keyboard support, the following table details arrow key support for dropdown menus: +`ion-popover` has full arrow key support for navigating between `ion-item` elements with the `button` property. The most common use case for this is as a dropdown menu. In addition to the basic keyboard support, the following table details arrow key support for dropdown menus: | Key | Description | | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | diff --git a/versioned_docs/version-v8/core-concepts/fundamentals.mdx b/versioned_docs/version-v8/core-concepts/fundamentals.mdx index 0d13c696ab..b5c1791a69 100644 --- a/versioned_docs/version-v8/core-concepts/fundamentals.mdx +++ b/versioned_docs/version-v8/core-concepts/fundamentals.mdx @@ -36,7 +36,7 @@ For apps that are built with Angular and `@ionic/angular`, we recommend using th ## Native Access -An amazing feature of apps built with web technologies (such as Ionic apps!) is that it can run on virtually any platform: desktop computers, phones, tablets, cars, refrigerators, and more! The same code base for Ionic apps can work on many platforms because it is based on web standards and common APIs that are shared across these platforms. +An amazing feature of apps built with web technologies (such as Ionic apps!) is that it can run on virtually any platform: desktop computers, phones, tablets, cars, refrigerators, and more! The same code base for Ionic apps can work on many platforms because it is based on web standards and common APIs that are shared across these platforms. That said, Ionic Framework is designed and tested for mobile platforms. Refer to [Browser Support](../reference/browser-support.mdx) for the platforms it officially supports. One of the most common use cases for Ionic is to build an app which can be downloaded from both the [App Store](https://www.apple.com/ios/app-store/) and [Play Store](https://play.google.com/). Both iOS and Android software development kits (SDKs) provide [Web Views](webview.mdx) which render any Ionic app, while still allowing for _full_ Native SDK access. diff --git a/versioned_docs/version-v8/reference/browser-support.mdx b/versioned_docs/version-v8/reference/browser-support.mdx index febc9ec9cb..2159b40824 100644 --- a/versioned_docs/version-v8/reference/browser-support.mdx +++ b/versioned_docs/version-v8/reference/browser-support.mdx @@ -38,6 +38,12 @@ To figure out what version of the webview a device is running, log `window.navig ## Browsers +:::note + +Ionic apps can run in desktop browsers, and nothing in Ionic Framework prevents it. However, Ionic is designed and tested for the mobile platforms listed above, so desktop usage is not officially supported. + +::: + Ionic supports the following browsers: | Browser | Ionic v8 | Ionic v7 | Ionic v6 | Ionic v5 | Ionic v4 | From 6743567070bb5761ae339e1d1b8cdcb936308f48 Mon Sep 17 00:00:00 2001 From: Maria Hutt Date: Fri, 30 Oct 2026 10:46:29 -0700 Subject: [PATCH 2/4] docs(browser-support): scope the browsers table to mobile platforms --- docs/reference/browser-support.mdx | 4 ++-- versioned_docs/version-v8/reference/browser-support.mdx | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/reference/browser-support.mdx b/docs/reference/browser-support.mdx index 0e13491dd9..8ef87157c3 100644 --- a/docs/reference/browser-support.mdx +++ b/docs/reference/browser-support.mdx @@ -41,11 +41,11 @@ To figure out what version of the webview a device is running, log `window.navig :::note -Ionic apps can run in desktop browsers, and nothing in Ionic Framework prevents it. However, Ionic is designed and tested for the mobile platforms listed above, so desktop usage is not officially supported. +Ionic apps can run in desktop browsers, and nothing in Ionic Framework prevents it. However, Ionic is designed and tested for the [mobile platforms](#mobile-platforms) listed above, so desktop usage is not officially supported. ::: -Ionic supports the following browsers: +Ionic supports the following browser versions on the [mobile platforms](#mobile-platforms) listed above: | Browser | Ionic v9 | Ionic v8 | Ionic v7 | Ionic v6 | Ionic v5 | Ionic v4 | | :---------: | :------: | :------: | :------: | :------: | :------: | :------: | diff --git a/versioned_docs/version-v8/reference/browser-support.mdx b/versioned_docs/version-v8/reference/browser-support.mdx index 2159b40824..c07ee91d7f 100644 --- a/versioned_docs/version-v8/reference/browser-support.mdx +++ b/versioned_docs/version-v8/reference/browser-support.mdx @@ -40,11 +40,11 @@ To figure out what version of the webview a device is running, log `window.navig :::note -Ionic apps can run in desktop browsers, and nothing in Ionic Framework prevents it. However, Ionic is designed and tested for the mobile platforms listed above, so desktop usage is not officially supported. +Ionic apps can run in desktop browsers, and nothing in Ionic Framework prevents it. However, Ionic is designed and tested for the [mobile platforms](#mobile-platforms) listed above, so desktop usage is not officially supported. ::: -Ionic supports the following browsers: +Ionic supports the following browser versions on the [mobile platforms](#mobile-platforms) listed above: | Browser | Ionic v8 | Ionic v7 | Ionic v6 | Ionic v5 | Ionic v4 | | :---------: | :------: | :------: | :------: | :------: | :------: | From a613cdbacbc7c347c9a3f879e7e3217dd60e95ef Mon Sep 17 00:00:00 2001 From: Maria Hutt Date: Fri, 30 Oct 2026 10:46:29 -0700 Subject: [PATCH 3/4] docs(cross-platform): note that desktop usage is not officially supported --- docs/core-concepts/cross-platform.mdx | 2 +- versioned_docs/version-v8/core-concepts/cross-platform.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/core-concepts/cross-platform.mdx b/docs/core-concepts/cross-platform.mdx index cc937650ad..45d2a7328c 100644 --- a/docs/core-concepts/cross-platform.mdx +++ b/docs/core-concepts/cross-platform.mdx @@ -4,7 +4,7 @@ title: Cross Platform # Cross Platform -Ionic is built from the ground up to make development easy, no matter what platform you are building for. Ionic apps are truly cross-platform: able to run as an Android, iOS, Electron, and Progressive Web App (PWA), all from a single codebase. There are some points to keep in mind when optimizing an app to work across these platforms. +Ionic is built from the ground up to make development easy, no matter what platform you are building for. Ionic apps are truly cross-platform: able to run as an Android, iOS, Electron, and Progressive Web App (PWA), all from a single codebase. Electron and desktop browsers can run Ionic apps, but desktop usage is not officially supported. Refer to [Browser Support](../reference/browser-support.mdx#mobile-platforms) for the officially supported platforms. There are some points to keep in mind when optimizing an app to work across these platforms. ## Hardware APIs {/* #hardware-apis */} diff --git a/versioned_docs/version-v8/core-concepts/cross-platform.mdx b/versioned_docs/version-v8/core-concepts/cross-platform.mdx index 00763be7f2..fa83d78b62 100644 --- a/versioned_docs/version-v8/core-concepts/cross-platform.mdx +++ b/versioned_docs/version-v8/core-concepts/cross-platform.mdx @@ -4,7 +4,7 @@ title: Cross Platform # Cross Platform -Ionic is built from the ground up to make development easy, no matter what platform you are building for. Ionic apps are truly cross-platform: able to run as an Android, iOS, Electron, and Progressive Web App (PWA), all from a single codebase. There are some points to keep in mind when optimizing an app to work across these platforms. +Ionic is built from the ground up to make development easy, no matter what platform you are building for. Ionic apps are truly cross-platform: able to run as an Android, iOS, Electron, and Progressive Web App (PWA), all from a single codebase. Electron and desktop browsers can run Ionic apps, but desktop usage is not officially supported. Refer to [Browser Support](../reference/browser-support.mdx#mobile-platforms) for the officially supported platforms. There are some points to keep in mind when optimizing an app to work across these platforms. ## Hardware APIs From 8433d60ebbe5acb4d44a2cf9ef5db25b2d4664c2 Mon Sep 17 00:00:00 2001 From: Maria Hutt Date: Fri, 30 Oct 2026 10:46:29 -0700 Subject: [PATCH 4/4] docs(fundamentals): link to the mobile platforms list --- docs/core-concepts/fundamentals.mdx | 2 +- versioned_docs/version-v8/core-concepts/fundamentals.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/core-concepts/fundamentals.mdx b/docs/core-concepts/fundamentals.mdx index 77bc04f9ee..4edcad7cfb 100644 --- a/docs/core-concepts/fundamentals.mdx +++ b/docs/core-concepts/fundamentals.mdx @@ -36,7 +36,7 @@ For apps that are built with Angular and `@ionic/angular`, we recommend using th ## Native Access {/* #native-access */} -An amazing feature of apps built with web technologies (such as Ionic apps!) is that it can run on virtually any platform: desktop computers, phones, tablets, cars, refrigerators, and more! The same code base for Ionic apps can work on many platforms because it is based on web standards and common APIs that are shared across these platforms. That said, Ionic Framework is designed and tested for mobile platforms. Refer to [Browser Support](../reference/browser-support.mdx) for the platforms it officially supports. +An amazing feature of apps built with web technologies (such as Ionic apps!) is that it can run on virtually any platform: desktop computers, phones, tablets, cars, refrigerators, and more! The same code base for Ionic apps can work on many platforms because it is based on web standards and common APIs that are shared across these platforms. That said, Ionic Framework is designed and tested for mobile platforms. Refer to [Browser Support](../reference/browser-support.mdx#mobile-platforms) for the platforms it officially supports. One of the most common use cases for Ionic is to build an app which can be downloaded from both the [App Store](https://www.apple.com/ios/app-store/) and [Play Store](https://play.google.com/). Both iOS and Android software development kits (SDKs) provide [Web Views](webview.mdx) which render any Ionic app, while still allowing for _full_ Native SDK access. diff --git a/versioned_docs/version-v8/core-concepts/fundamentals.mdx b/versioned_docs/version-v8/core-concepts/fundamentals.mdx index b5c1791a69..7e3aea8cba 100644 --- a/versioned_docs/version-v8/core-concepts/fundamentals.mdx +++ b/versioned_docs/version-v8/core-concepts/fundamentals.mdx @@ -36,7 +36,7 @@ For apps that are built with Angular and `@ionic/angular`, we recommend using th ## Native Access -An amazing feature of apps built with web technologies (such as Ionic apps!) is that it can run on virtually any platform: desktop computers, phones, tablets, cars, refrigerators, and more! The same code base for Ionic apps can work on many platforms because it is based on web standards and common APIs that are shared across these platforms. That said, Ionic Framework is designed and tested for mobile platforms. Refer to [Browser Support](../reference/browser-support.mdx) for the platforms it officially supports. +An amazing feature of apps built with web technologies (such as Ionic apps!) is that it can run on virtually any platform: desktop computers, phones, tablets, cars, refrigerators, and more! The same code base for Ionic apps can work on many platforms because it is based on web standards and common APIs that are shared across these platforms. That said, Ionic Framework is designed and tested for mobile platforms. Refer to [Browser Support](../reference/browser-support.mdx#mobile-platforms) for the platforms it officially supports. One of the most common use cases for Ionic is to build an app which can be downloaded from both the [App Store](https://www.apple.com/ios/app-store/) and [Play Store](https://play.google.com/). Both iOS and Android software development kits (SDKs) provide [Web Views](webview.mdx) which render any Ionic app, while still allowing for _full_ Native SDK access.