[PWA-75] Add PWA Wrapper documentation and capabilities overview by YogendraShelke · Pull Request #10931 · mendix/docs

YogendraShelke · 2026-03-26T08:47:38Z

No description provided.

ConnorLand · 2026-03-26T08:59:36Z

Are these docs tied to a release (SP or otherwise) or can they be merged whenever @YogendraShelke ?

YogendraShelke · 2026-03-26T09:59:18Z

Are these docs tied to a release (SP or otherwise) or can they be merged whenever @YogendraShelke ?

PWA Wrapper will be announced with the 11.9 release, but it is also supported on 10.24. It makes sense to publish these docs only after the PWA Wrapper marketplace module is released. I will confirm the timing once that release is completed.

ConnorLand · 2026-03-26T14:31:26Z

Ok, thank you @YogendraShelke, I'll wait to merge until you confirm the module release date. Cheers.

YogendraShelke · 2026-04-02T15:19:29Z

Hi @ConnorLand, the PWA Wrapper has been published on the Marketplace. You can proceed with publishing the documentation now.

ConnorLand · 2026-04-03T14:10:14Z

I didn't get to editing these this week, but it's the top of my list for editing/merging when I get back from PTO on April 13 @YogendraShelke . It's got prio.

jdiehl

Great job on the documentation! Very clear!

jdiehl · 2026-04-07T09:37:50Z

content/en/docs/refguide/mobile/pwa-wrapper/_index.md

+
+Keep the following beta limitations in mind:
+
+* The current beta release supports Android and iOS only


Please remove this - see above for reasoning

jdiehl · 2026-04-07T09:38:10Z

content/en/docs/refguide/mobile/pwa-wrapper/_index.md

+
+PWA Wrapper lets you package a Mendix progressive web app (PWA) as a native mobile app for Android and iOS. This is useful when you want to keep a web-based application architecture while distributing the app through app stores, installing it on managed devices, or adding a small set of commonly used hardware capabilities.
+
+In the current beta release, the scope of PWA Wrapper is limited to Android and iOS.


Please remove this - I don't think limiting support to Android and iOS is a true limitation. We can introduce harmony os and other architectures later as features, not as limitation removers

jdiehl · 2026-04-07T09:48:53Z

content/en/docs/refguide/mobile/pwa-wrapper/pwa-wrapper-capabilities.md

+When you build a Mendix app with PWA Wrapper capabilities, follow these guidelines:
+
+* Request permissions only when they are needed in the user flow
+* Add clear fallback logic for devices where a capability is unavailable


Replace with below's broader guideline that also includes users rejecting access:

Handle denied permissions or unsupported devices by providing clear fallback logic.

jdiehl · 2026-04-07T09:49:15Z

content/en/docs/refguide/mobile/pwa-wrapper/pwa-wrapper-limitations.md

+
+Keep the following product-level limitations in mind:
+
+* The current beta release supports Android and iOS only


Remove this - see above

jdiehl · 2026-04-07T09:52:05Z

content/en/docs/refguide/mobile/pwa-wrapper/sign-pwa-wrapper-apps.md

+Keep the following recommendations in mind:
+
+* Use one stable signing configuration per app line if you plan to publish updates
+* Back up the generated Android signing directory before moving to another machine


Please add instructions where to find the Android keystore

Is this not the place mentioned in the Manage Signing Configurations section, above?

MarkvanMents

I am most of the way through the review.
I wonder whether this documentation should be in a non-versioned area such as Marketplace. It doesn't make sense to be saying that it can be used on 10.24 when the documentation is in the Mendix 11 documentation. We could just have a landing page here, but all the instructions in the Marketplace.

I also see that the Marketplace module is not platform supported. Should this be changed now, or only when it comes out of beta.

I'll complete the review tomorrow.

MarkvanMents · 2026-04-08T10:22:13Z

content/en/docs/refguide/mobile/pwa-wrapper/_index.md

+
+PWA Wrapper lets you package a Mendix progressive web app (PWA) as a native mobile app for Android and iOS. This is useful when you want to keep a web-based application architecture while distributing the app through app stores, installing it on managed devices, or adding a small set of commonly used hardware capabilities.
+
+In the current beta release, the scope of PWA Wrapper is limited to Android and iOS.


MarkvanMents · 2026-04-08T10:31:40Z

content/en/docs/refguide/mobile/pwa-wrapper/_index.md

+
+Keep the following beta limitations in mind:
+
+* The current beta release supports Android and iOS only


MarkvanMents · 2026-04-08T10:34:26Z

content/en/docs/refguide/mobile/pwa-wrapper/_index.md

+## Read More
+
+* [Install PWA Wrapper](/refguide/mobile/pwa-wrapper/install-pwa-wrapper/)
+* [Build PWA Wrapper Apps](/refguide/mobile/pwa-wrapper/build-pwa-wrapper-apps/)
+* [Sign PWA Wrapper Apps](/refguide/mobile/pwa-wrapper/sign-pwa-wrapper-apps/)
+* [PWA Wrapper Capabilities](/refguide/mobile/pwa-wrapper/pwa-wrapper-capabilities/)
+* [PWA Wrapper Limitations](/refguide/mobile/pwa-wrapper/pwa-wrapper-limitations/)


I don't think we need these - we normally only add Read More sections if the sections aren't linked above - and we already have all these listed very clearly.

MarkvanMents · 2026-04-08T13:56:11Z

content/en/docs/refguide/mobile/pwa-wrapper/build-pwa-wrapper-apps.md

+## Choosing Permissions and Packaging Options
+
+When configuring the wrapper, only enable the permissions and capabilities that your app actually uses. This reduces unnecessary prompts for end users and makes app review easier.
+
+For a practical mapping between capabilities and the permissions you typically need to configure, see [Capability to Permission Mapping](/refguide/mobile/pwa-wrapper/pwa-wrapper-capabilities/#capability-to-permission-mapping).
+


This seems to duplicate what is already in the steps. I don't think it adds anything.

MarkvanMents · 2026-04-08T13:57:16Z

content/en/docs/refguide/mobile/pwa-wrapper/build-pwa-wrapper-apps.md

+
+For a practical mapping between capabilities and the permissions you typically need to configure, see [Capability to Permission Mapping](/refguide/mobile/pwa-wrapper/pwa-wrapper-capabilities/#capability-to-permission-mapping).
+
+If the builder offers a choice to skip copying web resources, use that option carefully. Skipping resource copy makes packaging faster, but the wrapped app will fetch its frontend resources from the runtime instead of using packaged resources.


This should be in the Android section only as you can't package resources on an iOS.

MarkvanMents · 2026-04-08T14:44:11Z

content/en/docs/refguide/mobile/pwa-wrapper/sign-pwa-wrapper-apps.md

+
+This page explains the signing step within the PWA Wrapper build flow. It covers Android signing on Windows and macOS, iOS signing on macOS, and the Windows-to-macOS handoff required for final iOS signing.
+
+Use this page as a reference while completing [Build PWA Wrapper Apps](/refguide/mobile/pwa-wrapper/build-pwa-wrapper-apps/).


Not sure what you mean here. If there are things that need referencing then the links should be in the build guide. I don't think we need to mention it here.

MarkvanMents · 2026-04-08T14:50:56Z

content/en/docs/refguide/mobile/pwa-wrapper/sign-pwa-wrapper-apps.md

+Keep the following recommendations in mind:
+
+* Use one stable signing configuration per app line if you plan to publish updates
+* Back up the generated Android signing directory before moving to another machine


Is this not the place mentioned in the Manage Signing Configurations section, above?

MarkvanMents · 2026-04-08T14:52:53Z

content/en/docs/refguide/mobile/pwa-wrapper/sign-pwa-wrapper-apps.md

+1. Open PWA Wrapper and select **Android**.
+2. Go to the signing step.
+3. Select **Create New Signature**.
+4. Enter a unique signature name such as `test`, `qa`, or `production`.


The one in the image isn't any of these, it is "debug". I think the suggestions should match the image.

feat: add PWA Wrapper documentation and capabilities overview

b1b5490

YogendraShelke changed the title ~~Add PWA Wrapper documentation and capabilities overview~~ [PWA-75] Add PWA Wrapper documentation and capabilities overview Mar 26, 2026

ConnorLand self-assigned this Mar 26, 2026

ConnorLand added the Future release label Mar 26, 2026

YogendraShelke added 2 commits April 1, 2026 12:10

feat: enrich PWA Wrapper docs with visual examples and screenshots

9b660e7

fix: update PWA Wrapper Marketplace link to the correct component

ac2584b

jdiehl suggested changes Apr 7, 2026

View reviewed changes

MarkvanMents self-requested a review April 8, 2026 09:00

MarkvanMents self-assigned this Apr 8, 2026

MarkvanMents added the Needs language review label Apr 8, 2026

MarkvanMents added 3 commits April 8, 2026 15:07

Partial Proofread

84293c7

Merge branch 'development' into pr/YogendraShelke/10931

1fada9d

Partial Review

96b988b

MarkvanMents reviewed Apr 8, 2026

View reviewed changes


		Keep the following beta limitations in mind:

		* The current beta release supports Android and iOS only


		PWA Wrapper lets you package a Mendix progressive web app (PWA) as a native mobile app for Android and iOS. This is useful when you want to keep a web-based application architecture while distributing the app through app stores, installing it on managed devices, or adding a small set of commonly used hardware capabilities.

		In the current beta release, the scope of PWA Wrapper is limited to Android and iOS.


		Keep the following product-level limitations in mind:

		* The current beta release supports Android and iOS only


		For a practical mapping between capabilities and the permissions you typically need to configure, see [Capability to Permission Mapping](/refguide/mobile/pwa-wrapper/pwa-wrapper-capabilities/#capability-to-permission-mapping).

		If the builder offers a choice to skip copying web resources, use that option carefully. Skipping resource copy makes packaging faster, but the wrapped app will fetch its frontend resources from the runtime instead of using packaged resources.


		This page explains the signing step within the PWA Wrapper build flow. It covers Android signing on Windows and macOS, iOS signing on macOS, and the Windows-to-macOS handoff required for final iOS signing.

		Use this page as a reference while completing [Build PWA Wrapper Apps](/refguide/mobile/pwa-wrapper/build-pwa-wrapper-apps/).

Conversation

YogendraShelke commented Mar 26, 2026

Uh oh!

ConnorLand commented Mar 26, 2026

Uh oh!

YogendraShelke commented Mar 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ConnorLand commented Mar 26, 2026

Uh oh!

YogendraShelke commented Apr 2, 2026

Uh oh!

ConnorLand commented Apr 3, 2026

Uh oh!

jdiehl left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

MarkvanMents left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

YogendraShelke commented Mar 26, 2026 •

edited

Loading