Install as an app (PWA)

Orimora is a Progressive Web App (PWA): you can install it from your browser and run it like a native desktop or mobile app — its own window, a launcher/home-screen icon, and notifications where the platform supports them.

Note

Orimora is online-only by design — there is no offline mode. The app shell (scripts, styles, fonts, icons) is cached so it loads fast, but opening or editing documents always needs a connection. See Online only below.

What you get as an installed app

• Standalone window — no browser tabs or address bar.
• Home-screen / launcher icon (with an adaptive “maskable” icon on Android).
• App shortcuts — jump straight to New document or Search from the icon’s right-click / long-press menu (Chrome, Edge, Android).
• Theme-aware chrome — the title bar / task switcher picks up Orimora’s accent color and your light/dark theme.
• Push notifications — on supported browsers (see below), once enabled under Settings → Notifications.
• Notch / safe-area support — full-screen layout respects rounded corners and the home indicator on modern phones.

Install it

You need to reach Orimora over HTTPS (any production deployment does; localhost also works for development).

• Chrome / Edge (desktop): click the install icon in the address bar (a monitor with a down-arrow), or use the browser menu → Install Orimora….
• Android (Chrome): menu (⋮) → Add to Home screen / Install app.
• iOS / iPadOS (Safari): Share button → Add to Home Screen. (Safari is the only browser that can install web apps on iOS.)
• Firefox (desktop): Firefox does not install PWAs as standalone apps; you can still use Orimora normally in a tab. On Android, Firefox offers Add to Home screen.

There is no in-app “Install” button — installation is handled by your browser’s native UI.

Online only

Orimora is a real-time, collaborative editor (live cursors, server-rendered pages), so a full offline mode would be misleading rather than helpful. The service worker therefore uses a deliberate, conservative strategy:

Resource	Cached?	Behaviour
App shell (/_app/…, fonts, icons)	✅ cache-first	Loads instantly, even on a flaky connection
Pages / documents (HTML)	network-first	Always fetched fresh; fails without a connection
API, uploads, auth	never cached	Always live

What this means offline: if you lose your connection, navigating to a page you haven’t loaded shows your browser’s native “you’re offline” screen. There is intentionally no offline document cache, no offline editing, and no background sync — reconnect and reload.

Notifications

Web Push works in the installed app on Chrome, Edge, Firefox and Android. Enable it under Settings → Notifications (your browser will ask for permission).

Caution

Apple does not support Web Push the way other browsers do. Installed Orimora apps on iOS / iPadOS / Safari do not receive push notifications, even when added to the home screen. Everything else (standalone window, icon, in-app notifications) still works. Operators must also configure VAPID keys (VAPID_PUBLIC_KEY / VAPID_PRIVATE_KEY) for push to be available at all — see Configuration.

Browser support at a glance

Capability	Chrome / Edge	Firefox	Safari / iOS	Android (Chrome)
Install as standalone app	✅	Desktop ❌ · Android via Home screen	✅ Add to Home Screen	✅
Home-screen icon	✅	✅	✅	✅
App shortcuts	✅	❌	❌	✅
Push notifications	✅	✅	❌ (Apple)	✅
Theme color / safe-area	✅	✅	✅	✅
Offline access	❌ (by design)	❌	❌	❌

Not supported

By design, Orimora does not implement: offline access / offline editing, background sync, periodic sync, a share target, or an app-icon unread badge. These would only make sense for an offline-first app; Orimora is intentionally online-first.

Related

• Notifications — in-app and push notifications
• Configuration — VAPID / Web Push setup for operators