Skip to content

docs(desktop): clarify that desktop usage is not officially supported #4814

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
thetaPC merged 4 commits into from
Oct 30, 2026
Merged

docs(desktop): clarify that desktop usage is not officially supported #4814

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
cd07473
docs(desktop): clarify that desktop usage is not officially supported
thetaPC Oct 29, 2026
6743567
docs(browser-support): scope the browsers table to mobile platforms
thetaPC Oct 30, 2026
a613cdb
docs(cross-platform): note that desktop usage is not officially suppo…
thetaPC Oct 30, 2026
8433d60
docs(fundamentals): link to the mobile platforms list
thetaPC Oct 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/api/popover.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -212,7 +212,7 @@ type PositionAlign = 'start' | 'center' | 'end';
| <kbd>Esc</kbd> | Closes the popover. |
| <kbd>Space</kbd> or <kbd>Enter</kbd> | 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 |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion docs/core-concepts/cross-platform.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 */}

Expand Down
2 changes: 1 addition & 1 deletion docs/core-concepts/fundamentals.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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#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.

Expand Down
8 changes: 7 additions & 1 deletion docs/reference/browser-support.mdx
View file
Open in desktop

@brandyscarney brandyscarney Oct 29, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Commenting here for thread

Cross Platform still says Ionic apps can run as an Electron app, which reads as desktop support. Should it get the same ‘can run, not officially supported’ wording (or a link to Browser Support) so the docs give one answer? See below link

ionic-docs/docs/core-concepts/cross-platform.mdx

Line 7 in cd07473

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.

@ShaneK ShaneK Oct 30, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1, and the v8 copy has it too. We missed this line when #3366 removed the desktop section from that page, so I think it fits in this PR, but a follow-up is fine if you'd rather keep this one small.

@thetaPC thetaPC Oct 30, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch, done in a613cdb. It now says Electron and desktop browsers can run Ionic apps but desktop usage is not officially supported, with a link to the mobile platforms list.

Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,13 @@ To figure out what version of the webview a device is running, log `window.navig

## Browsers {/* #browsers */}

Ionic supports the following 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](#mobile-platforms) listed above, so desktop usage is not officially supported.

:::

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 |
| :---------: | :------: | :------: | :------: | :------: | :------: | :------: |
Expand Down
2 changes: 1 addition & 1 deletion versioned_docs/version-v8/api/popover.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -212,7 +212,7 @@ type PositionAlign = 'start' | 'center' | 'end';
| <kbd>Esc</kbd> | Closes the popover. |
| <kbd>Space</kbd> or <kbd>Enter</kbd> | 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 |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion versioned_docs/version-v8/core-concepts/cross-platform.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
2 changes: 1 addition & 1 deletion versioned_docs/version-v8/core-concepts/fundamentals.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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#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.

Expand Down
8 changes: 7 additions & 1 deletion versioned_docs/version-v8/reference/browser-support.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,13 @@ To figure out what version of the webview a device is running, log `window.navig

## Browsers

Ionic supports the following 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](#mobile-platforms) listed above, so desktop usage is not officially supported.

:::

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 |
| :---------: | :------: | :------: | :------: | :------: | :------: |
Expand Down
Loading