Embedded App on POS - UI-Modal with app-bridge-react, landscape (Android) and debugging?

Shopify Apps

Topic summary

Embedded Shopify app enabled for POS via toml [pos] embedded = true; tile installs successfully. App shows a summary list and uses app-bridge-react UI-Modal for details.

Issues raised on Android POS: the app ignores device auto-rotate, causing the right side of the list to be cut off with no ability to scroll or shrink. Question: can orientation be controlled or respected on POS devices?

UI-Modal does not render on POS; only a persistent loading spinner appears. Question: should app-bridge-react components behave the same on POS as in a browser?

Debugging needs: how to view console logs or remotely inspect the POS webview from a PC/browser?

Platform awareness: can the app detect it is running on POS and conditionally change behavior, or is it simply an iFrame with no platform-specific capabilities?

Key terms: POS (Point of Sale), app-bridge-react (Shopify’s React wrapper for App Bridge UI components), UI-Modal (modal dialog).

No answers or resolutions yet; all questions remain open.

Summarized with AI on December 20. AI used: gpt-5.
1

I have a working embedded app that displays a summary list and allows the user to click on a row and see a detailed modal window. I use the “app-bridge-react” ui-modal for the modal.

This app would be useful to my customer at point of sale, so I updated my toml file to:

[pos]
embedded = true

and was able to install a tile on the POS for the app. Cool so far.

A few questions:

(1) On my Android phone, the app doesn’t respect my phone’s auto-rotate setting - and because of this I can’t see the right portion of my list window. I can’t scroll or shrink to make it visible either. Is this fixable? My specific case aside, can we control orientation?

(2) The modal window doesn’t show on the POS - I just have a never-ending progress indicator spinning. Should I expect “app-bridge-react” components to work as they do on a browser?

(3) How does one debug apps running on POS device? Can I see console log or connect into the PC with a browser to observe?

(4) It seems the app is intended to run unchanged on the POS device. Is there an idea of conditional behavior depending on the platform? That is, at runtime my app can detect the platform and do something different? Or is it just an iFrame running on the POS?

Thanks!