[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!

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

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

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

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.

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

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.

MarkvanMents

I have now finished my review.
I have a few minor questions, but my main concern is the position of these documents in the navigation.
I'll open a chat on Slack to make the discussion easier.
Thanks for the big PR - apologies for the delay in dealing with it.

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

MarkvanMents · 2026-04-09T12:06:50Z

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

+
+Support can vary by platform, operating system version, browser engine, and configured permissions. Always test the capabilities you depend on on the actual devices you plan to support.
+
+In the current beta release, PWA Wrapper capabilities are documented for Android and iOS.


We list capabilities but don't actually identify any which are not available for Android or iOS. I don't think we need to say this - and we can always expand the tbale in the permission mapping if we decide to support other operating systems.

MarkvanMents · 2026-04-09T12:56:37Z

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

+* the app is loaded over HTTPS
+* the app is accessed from `localhost` during local development
+
+If the wrapped app is loaded from an insecure HTTP origin, capabilities that depend on Web APIs such as geolocation, notifications, permission handling, network information, or Share API flows may not work as expected.


Is this something the user should be handling as described in Designing with Capabilities?

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

MarkvanMents · 2026-04-09T13:00:02Z

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

+
+## Introduction
+
+This page summarizes the main cross-cutting limitations of PWA Wrapper in the current beta release.


What do you mean by "cross-cutting"?

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

MarkvanMents reviewed Apr 10, 2026

View reviewed changes

Finish proofreading

03d8da4

MarkvanMents removed the Future release label Apr 10, 2026


		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/).


		Support can vary by platform, operating system version, browser engine, and configured permissions. Always test the capabilities you depend on on the actual devices you plan to support.

		In the current beta release, PWA Wrapper capabilities are documented for Android and iOS.


		## Introduction

		This page summarizes the main cross-cutting limitations of PWA Wrapper in the current beta release.

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!

Uh oh!

Uh oh!

Uh oh!

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!

Uh oh!

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!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

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