Skip to content

Fix iOS PWA to reuse app instance instead of opening new tabs#189

Merged
djdefi merged 2 commits intomainfrom
copilot/fix-home-screen-app-tab-issue
Dec 17, 2025
Merged

Fix iOS PWA to reuse app instance instead of opening new tabs#189
djdefi merged 2 commits intomainfrom
copilot/fix-home-screen-app-tab-issue

Conversation

Copy link
Contributor

Copilot AI commented Dec 17, 2025

iOS Safari opens a new browser tab each time users tap the home screen icon instead of returning to the existing PWA instance.

Changes

  • templates/manifest.json.erb: Set display: "standalone" and start_url: "./"

    • standalone mode signals iOS to treat this as an app, not browser content
    • Relative path ./ enables iOS to properly identify and reuse the running instance
  • test/render_test.rb: Added test_manifest_pwa_settings to validate manifest generation

Before/After

 {
   "name": "News Firehose",
-  "start_url": "index.html",
-  "display": "minimal-ui",
+  "start_url": "./",
+  "display": "standalone",
 }

The minimal-ui display mode doesn't provide sufficient isolation for iOS to maintain a single app instance.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • example.com
    • Triggering command: /usr/bin/ruby ruby render.rb (dns block)
  • www.nevadacountyca.gov
    • Triggering command: /usr/bin/ruby ruby render.rb (dns block)
    • Triggering command: /usr/bin/ruby ruby test/render_test.rb (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

Possible to make the home screen installed app / manifest not open a new tab every time the icon is clicked - iOS has this behavior in particular


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

…o ./

Co-authored-by: djdefi <3662109+djdefi@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix home screen manifest behavior for installed apps Fix iOS PWA to reuse app instance instead of opening new tabs Dec 17, 2025
@djdefi djdefi marked this pull request as ready for review December 17, 2025 03:38
Copilot AI requested a review from djdefi December 17, 2025 03:38
@djdefi djdefi merged commit d592bbc into main Dec 17, 2025
7 checks passed
@djdefi djdefi deleted the copilot/fix-home-screen-app-tab-issue branch December 17, 2025 04:10
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