This document describes the format of deeplinks for the mobile container and the desktop app. We are trying (as much as possible) to keep the deeplinks unified between the two platforms.

Unified deeplinks

• download and open a .remix file: com.remixlabs.runtime://localhost/run-remix-file?<url>&<workspace?>&<app?>&<screen?>&<params?>
  • this will download a hosted .remix, install it locally and run it.
  • before installing the .remix file, the user will be presented with a confirmation screen showing what the file contains (list of flows, list of widgets, etc…)
  • if the .remix only has one app, the home screen of that app is opened, but you can override this if needed (not yet supported on mobile)
  • ex: com.remixlabs.runtime://localhost/run-remix-file?url=https://storage.googleapis.com/rmx-content/draft/about-us-remixV4.remix
• open a screen (of an already installed app): com.remixlabs.runtime://localhost/open-screen?<workspace?>&<app>&<screen?>&<params?>
  • if screen is not specified, home is being used

the workspace parameter is only meaningful on desktop.

Desktop-only deeplinks

• open an artifact: com.remixlabs.runtime://localhost/open-artifact?<url>&<mode?>
  • open the artfifact viewer with the given artifact url and mode (default mode is configure, which will dynamically switch to run if the artifact doesn’t expose any configuration node)

Mobile-only deeplinks

• TODO DDA: document the old style mobile deeplinks