Install Shoreline as an app on your device
Shoreline Platform is a Progressive Web App (PWA) that you can install on Android, Windows, macOS, iOS, or Linux and launch like a native application — with its own icon, full-screen window, and offline-aware behaviour. On Android and desktop, installation is offered automatically on your first visit; on iPhone and iPad, you must add it manually through Safari.
Before you start
- Shoreline must be accessed over HTTPS. PWAs cannot be installed over plain HTTP.
- Installation is supported on Android, Windows, macOS, and Linux using a Chromium-based browser (a recent version of Chrome or Edge).
- On iPhone and iPad, install through Safari using the Share menu. Automatic installation prompts are not supported on iOS; you must add the app to your home screen manually.
How do I install Shoreline on Android, Windows, macOS, or Linux?
Shoreline will offer to install itself automatically the first time you open it on a supported device. You can also install at any time from the login page.
- Open the Shoreline Platform in Chrome or Edge.
- When the Install this app for a better experience prompt appears, click Install.
- Confirm the installation in your browser's dialog.
- Shoreline opens in its own window with the Shoreline icon on your desktop or home screen.
Install from the login page
If you dismissed the prompt or never saw it, you can install from the login page:
- Open the Shoreline Platform login page.
- Click the Install this app for a better experience button below the sign-in form.
- Confirm the installation in your browser's dialog.
Note: If you click Later to dismiss the install prompt, it will not appear again for two weeks. You can still install at any time from the login page button.
Install Shoreline on iPhone or iPad
iOS does not support automatic installation, so Shoreline must be added to the home screen manually using Safari.
- Open the Shoreline Platform in Safari.
- Tap the Share icon (the box with an arrow pointing up). On iPhone it appears at the bottom of the screen; on iPad it appears in the top toolbar.
- Scroll down and tap Add to Home Screen.
- Confirm the name and tap Add.
- The Shoreline icon now appears on your home screen and launches the app in its own window.
Tip: Shoreline will prompt you with these instructions automatically the first time you open it in Safari. Tap Got it to dismiss the prompt — it will not reappear for two weeks.
Offline behaviour
When Shoreline is installed as a PWA, the app caches its core assets so subsequent launches are faster. If you launch the installed app without a network connection, an offline fallback screen is displayed:
You're offline It looks like you've lost your internet connection. Check your network and try again.
Click Try again when you have reconnected to reload the app.
Tip: You do not need to reinstall the app after going offline. Simply reconnect to your network and tap or click Try again to resume where you left off.
Note: Going offline only affects the app shell — the core interface and navigation. Live data (work orders, defects, and checklists) requires an active network connection.
Updates
When a new version of Shoreline is available, an update prompt appears inside the installed app:
A new version is available.
Click Update now to refresh immediately, or click Dismiss to keep working and update later. The prompt is non-blocking, so you can finish what you're doing before applying the update.
Where to find it
| Action | Where |
|---|---|
| Automatic install prompt | First visit on supported devices |
| Manual install (Android, desktop) | Login page → Install this app for a better experience button |
| Manual install (iOS) | Safari → Share → Add to Home Screen |
| Offline fallback | Anywhere in the app, when network is unavailable |
| Update prompt | Anywhere in the app, after a new release is deployed |
What is hidden on mobile
A few features remain desktop-focused in this release and are hidden on phone and tablet viewports:
- Work Order Progress Dashboard
This list will be updated as features are made available on mobile.
Troubleshooting
Why is the install prompt not appearing?
The automatic install prompt only appears on supported browsers (a recent version of Chrome or Edge) over HTTPS. If you dismissed the prompt previously, it will not reappear for two weeks. To install immediately, open the Shoreline Platform login page and click the Install this app for a better experience button below the sign-in form.
Why is the install button missing from the login page?
The install button is hidden if Shoreline is already installed on your device or if your browser does not support PWA installation. Verify you are using a recent version of Chrome or Edge and that the page is loaded over HTTPS. If you previously uninstalled the app, try clearing your browser cache and reloading the login page.
Why is the Add to Home Screen option not appearing in Safari on iPhone or iPad?
PWA installation via Safari requires a recent version of iOS. If the option does not appear, update your device through Settings > General > Software Update and then retry the steps in the How do I install Shoreline on iPhone or iPad? section above.