Progressive Web App (PWA) Support

Alongside the official native iOS, Android, and Desktop apps, Spokes also supports installing the web interface as a Progressive Web App (PWA).

Installing Spokes as a PWA gives you:

• Custom Server Branding: Spokes dynamically generates its Web App Manifest (/spokesapi/Manifest) using the Server Name and Icon configured in your server settings, so the installed app uses your server's name and icon.
• Standalone Window: Run Spokes in its own window without browser tabs or address bars.
• Free Web Push Notifications Forever: Spokes automatically generates VAPID keys on your server on first boot (manageable under Server Settings -> System Setup -> Browser Push (VAPID) Keys). Browser and PWA push notifications are sent directly from your server with no relay or Spokes Pass required.

How to Install

On Desktop (Chrome / Edge / Brave)

1. Open your Spokes server URL in your browser.
2. Click the Install icon on the right side of the address bar (it looks like a monitor with a down arrow).
3. Select Install.
4. Spokes will open in its own window and appear in your Start Menu, Dock, or application launcher.

On Mobile (iOS / Safari)

1. Open your Spokes server URL in Safari.
2. Tap the Share button at the bottom of the screen.
3. Scroll down and tap Add to Home Screen.
4. Tap Add in the top right corner.
5. The Spokes icon will appear on your home screen. (Note: On iOS 16.4 and newer, Apple requires adding a website to the Home Screen before it can receive Web Push notifications.)

On Mobile (Android / Chrome)

1. Open your Spokes server URL in Chrome.
2. Tap the three-dot menu icon in the top right corner.
3. Select Install app or Add to Home screen.
4. Follow the prompt to add Spokes to your home screen and app drawer.