Mobile access and installing the web app
Added in v0.1.6
The installable-app manifest, offline guidance, and mobile navigation drawer were introduced in v0.1.6 and remain available in v0.1.8. Installation does not add offline access to private data.
oonfeeWRT remains a responsive web application. Installing it adds a launcher and standalone window; it does not install the controller on your phone, create a cloud account, open firewall ports, or bypass controller sign-in.
Use the mobile layout
At narrow widths, Open navigation in the top bar opens the complete sidebar. Choose a workspace, select Close navigation, tap the backdrop, or press Escape to close it. Keyboard focus stays inside the open navigation and returns to the menu button when dismissed. Pages use the full available width when the drawer is closed. Settings, Accounts, and Logs remain in the Controller group at the end of the navigation, followed by your compact profile shortcut to Accounts.
In the v0.1.8 Precision layout, Workspace contains network tools and Insights contains Statistics, Reports, and Alerts. Open Settings for the Firmware and Integrations tabs; they are no longer separate sidebar buttons. Existing bookmarked /firmware and /integrations URLs still work. The mobile drawer has visible labels and touch-sized targets regardless of the desktop sidebar's saved collapsed or expanded preference.
The Dashboard fleet strip reflows from five desktop columns to two on tablets and one on narrow phones. Counts remain beside their labels; unavailable values and source explanations are not removed to make the layout smaller.
Install on a supported browser
- Connect to the controller's management network or your existing VPN.
- Open its usual URL. Use HTTPS for a controller on another machine; loopback URLs work for local development.
- Use the browser's Install app, Add to Home Screen, or Add to Dock action when available. Browser and operating-system support vary.
- Launch oonfeeWRT from its orbit-mark icon and sign in normally.
The app includes 192px/512px icons and a standalone-display manifest. HTTP on a remote LAN IP can still serve the ordinary UI, but does not meet installability requirements in browsers that require a secure origin. See MDN's installation requirements for current browser behavior.
When the controller is unreachable
The installed app can show a static explanation asking you to reconnect to the management network or VPN and check the controller process. It does not show a cached copy of your private network inventory, queue configuration changes, or claim an operation succeeded offline. Use Try again after restoring access.
The service worker does not cache API responses, authenticated HTML, or credentials. API requests, mutations, assets, and other origins are not intercepted by its offline-navigation handler. There is no offline controller or background management mode.
Upgrades and removal
Update the controller normally. Its embedded UI, service worker, and manifest are served by the same binary. The worker and manifest are revalidated rather than pinned as immutable assets. No router change results from installing, updating, or removing the app shortcut.
Remove the installed application through the browser or operating system. Removing a shortcut does not revoke a controller session; use Accounts → My account to review and revoke sessions when needed.