Skip to content

Add support for setting the app launch url#319

Merged
gabrieldonadel merged 3 commits intomainfrom
@gabrieldonadel/add-launch-url
Mar 18, 2026
Merged

Add support for setting the app launch url#319
gabrieldonadel merged 3 commits intomainfrom
@gabrieldonadel/add-launch-url

Conversation

@gabrieldonadel
Copy link
Copy Markdown
Member

@gabrieldonadel gabrieldonadel commented Mar 17, 2026

Why

We should allow Expo Agent to tell Orbit to open a specific deep link when installing a dev client build on a device. so that we can point the app at the correct development server instance.

How

Added an optional launchURL parameter to the /download deeplink. This also includes changes in:

  • CLI : When --launch-url is provided, uses the existing openURLAsync helpers instead of the normal app launch. Falls back to the default launch if the URL open fails.
  • URL parsing: The /download deeplink route extracts the optional launchURL from search params. Added a new DownloadDeeplinkURLType to the discriminated union to carry this field.

Test Plan

  • Added unit tests for launchURL parsing
  • Manual test: http://127.0.0.1:47909/orbit/open?url=expo-orbit%3A%2F%2F%2Fdownload%2F%3Furl%3Dhttps%253A%252F%252Fexpo.dev%252Fartifacts%252Feas%252Fv3WshxGCF87UzsHSxfRnAh.tar.gz%26launchURL%3Dmyapp%253A%252F%252Fexpo-development-client%252F%253Furl%253Dhttp%253A%252F%252Flocalhost%253A8081

@gabrieldonadel gabrieldonadel merged commit f3f7514 into main Mar 18, 2026
1 check passed
@gabrieldonadel gabrieldonadel deleted the @gabrieldonadel/add-launch-url branch March 18, 2026 16:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants