Install As A PWA

Install Bookmarks As A PWA

Bookmarks can be installed as a Progressive Web App (PWA) so it behaves like an app from your home screen or desktop.

Requirements

• A supported browser (Chrome, Edge, Safari, or Samsung Internet).
• HTTPS app URL (production/staging domains, not insecure HTTP).
• Latest deployed Bookmarks web build.

Install On Desktop

Chrome (Windows/Mac/Linux)

1. Open the Bookmarks web app URL.
2. Click the install icon in the address bar (computer + down arrow) or open the browser menu.
3. Select Install Bookmarks.
4. Launch from desktop/start menu like a normal app.

Edge (Windows/Mac)

1. Open the Bookmarks web app URL.
2. Use ... menu -> Apps -> Install this site as an app.
3. Confirm installation.
4. Optionally pin to taskbar/start.

Install On Android

Chrome

1. Open the Bookmarks app URL.
2. Tap menu (...) -> Add to Home screen or Install app.
3. Confirm.
4. Launch from home screen.

Samsung Internet

1. Open the Bookmarks app URL.
2. Tap menu -> Add page to -> Home screen.
3. Confirm.

Install On iPhone/iPad (Safari)

1. Open the Bookmarks app URL in Safari.
2. Tap Share.
3. Select Add to Home Screen.
4. Tap Add.

Note: iOS installation works only via Safari. Other iOS browsers use WebKit and do not expose equivalent install UX consistently.

What Changes After Install

• Bookmarks opens in an app-style window (desktop) or home-screen app shell (mobile).
• Session/auth works the same as browser login.
• Updates are delivered when a new web build/service worker is published and the app is refreshed/reopened.

Offline And Storage Notes

• PWA shell assets can be cached, but API-driven data still depends on network unless specific offline features are implemented.
• If storage is cleared in browser settings, local cached assets and session data may be removed.

Troubleshooting

Install Option Not Visible

• Confirm you are on the web app URL (not a raw file or insecure URL).
• Hard refresh and retry.
• Ensure manifest/service worker are present in the deployed build.

App Looks Stale After Deploy

• Close and reopen the installed app.
• On desktop, use Ctrl+Shift+R (or equivalent hard refresh).
• If needed, uninstall/reinstall to force a fresh shell.

Login Loops Or Auth Errors

• Verify API/auth base URLs in deployed environment config.
• Sign out and sign back in.
• Confirm backend worker/auth services are healthy.

Uninstall

• Desktop: right-click app in start menu/app launcher and uninstall.
• Android: long-press icon -> uninstall/remove.
• iOS: long-press icon -> Remove App.