Skip to main content
The Wrixton web app at projects.wrixton.xyz ships a full web app manifest and a service worker, which means you can install it to your phone’s home screen or your desktop like a native app. Once installed, it launches full-screen with no browser chrome, opens instantly from cache even without a network connection, and behaves like any other app on your device.

​
What “PWA” means for Wrixton

When you install Wrixton as a Progressive Web App, two things happen:
  1. App manifest — the browser reads the web app manifest, which sets the app name, the full-screen display mode, the brand colors, and the icons that appear on your home screen or taskbar.
  2. Service worker — a background script caches the app shell (the HTML, CSS, JavaScript, and icons) on first load. On subsequent launches, the shell loads from that cache immediately, even if you are offline.
The service worker intentionally does not cache your personal data. All data requests always go to the network, so your items are never stale. The app’s optimistic UI layer makes edits feel instant regardless — changes appear immediately in the interface and sync to the server in the background.

​
Install on iOS (Safari)

1

Open Wrixton in Safari

Navigate to projects.wrixton.xyz and sign in with your API key if prompted. The install must be done from Safari — other iOS browsers do not support home screen installation.
2

Tap the Share button

Tap the Share icon (the box with an arrow pointing up) in the Safari toolbar at the bottom of the screen.
3

Tap Add to Home Screen

Scroll through the share sheet and tap Add to Home Screen. You can edit the name before saving.
4

Tap Add

Tap Add in the top-right corner of the dialog. The Wrixton icon appears on your home screen immediately.
Tap the icon to launch Wrixton in full-screen standalone mode, with no Safari toolbar or address bar.

​
Install on Android

Open Wrixton in Chrome (or another Chromium-based browser) and look for the Add to Home Screen or Install App prompt. It may appear automatically as a banner at the bottom of the screen, or you can trigger it manually:
  1. Tap the browser’s ⋮ menu (three dots, top-right).
  2. Tap Add to Home screen or Install app.
  3. Confirm the name and tap Add or Install.
The app icon appears in your app drawer and on your home screen. Launch it for a full-screen experience identical to a native app.

​
Install on desktop (Chrome or Edge)

On Chrome and Edge, look for the install icon in the address bar — it looks like a monitor with a down-arrow or a circle with a plus sign. Click it, then click Install in the dialog that appears. Wrixton opens in its own window without browser tabs or the address bar. It also appears in your system’s app list and dock/taskbar so you can pin it for quick access.
If you do not see the install icon in the address bar, open the browser menu (⋮ or …) and look for Install Wrixton or Install Project & Todo Tracker there.

​
Offline behavior

Once installed and opened at least once with a network connection, Wrixton’s app shell is cached. If you open the app offline:
  • The UI loads immediately from the service worker cache.
  • Any list or item data from your last session may still be visible in the React state, depending on your browser.
  • Actions that require the network (loading fresh data, marking items done, adding items) will fail until connectivity is restored.
The app does not queue offline writes. Make sure you have a connection before adding or completing items.