Installing App to home screen with Safari causes "App not found" error

App works fine in the browser, but when I install to home screen I get a message “Not found - Bundled app not found, please re-publish your app”

I have republished several times plus tried to use the AI builder to help. This was the response:

This is a well-known iOS Safari behavior: web apps launched from a home-screen icon in standalone mode run in an isolated storage context, separate from Safari's normal browsing cookies/session. If the published app's server-side routing relies on a session cookie to resolve "which published bundle to serve" for that URL, a fresh standalone launch has none of that — it's essentially a brand-new, logged-out context — and the server falls back to a generic "bundled app not found" error instead of a proper sign-in prompt.

This lines up with everything you've reported:

  • Normal tab → has your existing Retool session cookies → resolves fine

  • Home-screen icon → new isolated storage, no cookies → can't identify the app → "not found"

This isn't something fixable by editing this app's frontend/backend code — it's about how the Retool hosting layer resolves and authenticates a published app for an installed PWA launch on iOS, which lives outside this repo entirely.

My recommendation: report this to Retool support with the exact repro, since it's a specific and actionable platform bug report:

  • App works normally when opened in a Safari tab

  • Same URL, added to home screen, opened via the icon → "Bundled app not found, please re-publish your app"

  • Occurs on iOS Safari specifically (standalone PWA launch)

Any help much appreciated, as I used to be able to install with no issue.

Thanks.

Summary

In the new app builder, a published app loads fine when opened in a Safari browser tab, but launching it from an iOS home-screen icon (standalone/PWA mode) returns "Not found - Bundled app not found, please re-publish your app," and republishing does not resolve it.

AI Response

This maps to a known Safari/WebKit issue with the new app builder: a home-screen (standalone PWA) launch runs in an isolated storage context with no existing Retool session cookies, so the platform can't resolve/authenticate the published bundle and falls back to a 'not found' error. Retool engineering has been actively addressing this class of WebKit authentication failure, and in reported cases it cleared up on its own after a fix. In the meantime, clearing cookies/site data and removing then re-adding the home-screen icon (or first signing in via a normal Safari tab) is the workaround that has restored access. This is a platform hosting/auth-layer behavior rather than something fixable in the app's own code.

Sources

:bookmark: New Retool Beta Apps don't work in safari and duck duck go browsers
A staff-confirmed known issue where new app builder apps fail to authenticate on Safari/WebKit while classic apps work; Retool shipped a fix and clearing cookies/incognito restored access.
:bookmark: Embedded Retool Apps are Unable to Login on Webkit Browsers (Safari, iOS Browsers, Gnome Web, etc.)
Documents how WebKit's isolated cookie handling on Safari/iOS blocks Retool session resolution, corroborating the root cause of a standalone launch being unable to identify the published app.

The Community Team is testing out a new automation. Let us know if it's helpful (or not) by leaving a :heart:, :+1:, or :-1:. Or by marking this post as the "Solution"! Let us know if you have any feedback here. :rocket:

Ok so I know why the error is happening, but don’t know why this is being caused our how to fix it

When added to the Home Screen, the folllwing is added to the app URL bookmark

https://appname.retool.app/_/assets/_c/614405/159c3537-248a-46d5-82cf-7be84ce25683/89c17323e2f508a620d280a16ea76d7622a25046/

Hi @mgh75! Welcome to the Community forum :waving_hand:

Sorry to hear that you are experiencing this issue - I'm looking into this now and will circle back soon with an update!

-Jen

Hi @mgh75 - thanks for your patience! Unfortunately, I was not able to repro this exact issue with the error message that you have been seeing :thinking:

To double-check with you, could you let me know the steps of how you are adding your app to your iOS home screen?

This is how I was able to add my app to my home screen - by clicking the "..." in the Safari browser, then "Share", and then "Add to Home Screen":


Based on the info you have provided, it sounds like the home screen bookmark was pinned to the wrong URL (the one with https://appname.retool.app/_/assets/...). That URL should be a path for a single published build's static assets, and not the app URL itself.

So, I think the "Add to Home Screen" just grabs whatever URL that was currently showing in the address bar at that moment during app load.

As a next step, could you delete your home screen shortcut icon, and go through the steps to add a fresh new one? Before saving, please wait until the page fully loads, and double-check that the right URL is showing https://appname.retool.app, not the one with https://appname.retool.app/_/assets/...

Let me know if you're still having this issue after doing this :slight_smile: Thanks!

-Jen