Document appstore QR links

Author: ThomasFarstrike

docs/apps/appstore.md

@@ -10,6 +10,27 @@ The AppStore app can pull apps from more than one source:
 
 Use the backend selector in the AppStore UI to switch between sources.
 
+## Scan QR
+
+The AppStore has a **Scan QR** button (QR icon, top-right) that opens an app's
+detail page directly from a scanned app link. It uses the Camera app in QR-scan
+mode — no typing needed.
+
+Supported app-link formats (case-insensitive):
+
+- `https://badgehub.eu/page/project/APP_ID`
+- `micropythonos://app/APP_ID`
+- `mpos://app/APP_ID`
+
+All three forms are equivalent: the link carries only the app's identity, and
+the AppStore resolves it against its trusted catalog. If the app list hasn't
+loaded yet, the AppStore downloads it first, then opens the detail page.
+
+If the code is not an app link, the AppStore offers it to installed apps that
+registered a matching URL handler, or shows a `Not an app link` message. If the
+linked app can't be found, it shows `App not found`; if the app list can't be
+downloaded, `No connection`.
+
 ## Example Apps
 
 - **Hello World**: A sample app demonstrating basic functionality.

docs/apps/badgehub.md

@@ -50,6 +50,10 @@ Releases on BadgeHub should use [semantic versioning](https://semver.org/) strin
 
 The AppStore app can switch between the curated MicroPythonOS backend and the BadgeHub backend. On supported firmware builds, BadgeHub is the default backend. Tap the backend selector in the AppStore UI to switch sources.
 
+## Sharing via QR
+
+To share your project on-device, point users at `https://badgehub.eu/page/project/<slug>` and have them tap **Scan QR** in the AppStore. See [App Store](appstore.md#scan-qr).
+
 ## See also
 
 - [Bundling Apps](bundling-apps.md) — creating `.mpk` packages

docs/architecture/intents.md

@@ -825,19 +825,19 @@ MicroPythonOS supports opening URLs (e.g., from QR codes) through a deep-link me
 QR codes can point directly to an app in the App Store using these link formats:
 
 ```
-https://apps.micropythonos.com/app/<app_id>[?v=<min_version>&s=<source>]
+https://badgehub.eu/page/project/<app_id>[?v=<min_version>&s=<source>]
 microPythonOS://app/<app_id>[?...]
 mpos://app/<app_id>[?...]
 ```
 
-All three forms are equivalent and case-insensitive (`MPOS://APP/COM.EXAMPLE.PAINT` works too). The link only carries the app's identity — never a download URL — so the App Store resolves it against its trusted catalog.
+All three forms are equivalent and case-insensitive (`MPOS://APP/COM.EXAMPLE.PAINT` works too). The link only carries the app's identity — never a download URL — so the App Store resolves it against its trusted catalog. The user-facing flow (the AppStore's **Scan QR** button) is described in [App Store](../apps/appstore.md#scan-qr).
 
 Opening a store link launches the App Store on the linked app's detail page:
 
 ```python
 from mpos.content.deeplink import open_url
 
-open_url("https://apps.micropythonos.com/app/com.example.myapp")
+open_url("https://badgehub.eu/page/project/com.example.myapp")
 ```
 
 ### Third-Party URL Handlers
@@ -862,7 +862,7 @@ Rules for `urlPattern`:
 
 - Must look like `scheme://host/...` with a literal host (no wildcards in host).
 - A trailing `*` is the only wildcard allowed and matches any suffix.
-- Patterns matching the official store host (`apps.micropythonos.com`) or the `mpos://` / `microPythonOS://` schemes are reserved for the system and rejected at registration.
+- Patterns matching the official store host (`badgehub.eu`) or the `mpos://` / `microPythonOS://` schemes are reserved for the system and rejected at registration.
 - Matching is a case-insensitive scheme-and-host prefix match.
 
 When a URL is opened, the system checks for matching third-party handlers. One match dispatches directly; several open the chooser. No sticky default is set, so a later-installed app is never permanently shadowed.