RentalMath
Offline & PWA Disclosure
How RentalMath works offline and as an installed Progressive Web App.
In This Document
1Progressive Web App
RentalMath is built as a Progressive Web App (PWA). A PWA is a web application that can be installed on your device like a native app and can function offline using cached resources. RentalMath meets the PWA criteria including HTTPS delivery, a Web App Manifest, and a Service Worker.
Installing RentalMath as a PWA is optional. The App functions identically whether accessed via browser or installed to your home screen. No app store is required for installation.
2Service Worker and What Is Cached
RentalMath registers a Service Worker in your browser. The Service Worker intercepts network requests and serves cached responses when you are offline or on a slow connection. The following types of resources are cached:
- App shell: HTML, CSS, and JavaScript files necessary to load and run the App interface.
- Static assets: Icons, fonts (if pre-cached), and other non-changing assets.
- Calculation engine: The JavaScript modules that perform real estate calculations are cached so they work offline.
The following are not cached by the Service Worker:
- Firebase Authentication tokens (managed by Firebase SDK).
- Firestore deal data (synced in real time; requires an internet connection for updates).
- Stripe payment flows (require a live internet connection).
- AI-powered features (require a live internet connection to the inference layer).
Service Worker caching uses the browser's Cache Storage API. See the Storage, Cookies & Caching Notice for storage quotas and how to clear cached data.
3Offline Functionality by Tier
Free Tier (No Account)
Free-tier users have the most complete offline experience. Because deal data is stored in localStorage (on-device), the full calculator is functional offline. You can create, edit, and analyze deals without an internet connection. New data is saved locally immediately.
Paid and Premium Tiers (Account Required)
Account holders can use the calculator offline, but:
- New deals or edits made offline are stored in localStorage temporarily and synced to Firestore when connectivity is restored.
- Deals stored only in Firestore (and not yet loaded into the local cache) may not be accessible offline.
- Cloud sync status indicators in the App reflect real-time connectivity; offline activity is logged and reconciled on reconnection.
- AI-powered features (Premium) are not available offline.
- Stripe billing and subscription management require an internet connection.
4Stale Content
Service Worker updates are applied automatically when:
- You close all tabs running RentalMath and reopen the App.
- The browser performs a background Service Worker check and finds an updated worker.
If you believe you are seeing an outdated version of the App, you can force a reload by:
- Performing a hard refresh (Ctrl+Shift+R on Windows/Linux, Cmd+Shift+R on Mac).
- Clearing the site's cache and storage via your browser's developer tools or site settings.
We are not liable for any issues arising from use of a stale cached version of the App after a material update has been deployed.
5Removing the Service Worker
You can unregister the RentalMath Service Worker at any time. Doing so removes the cached App shell and disables offline functionality. The App will still function when online. To unregister the Service Worker:
- Open your browser's developer tools (F12).
- Navigate to Application > Service Workers.
- Click "Unregister" next to the RentalMath service worker.
Alternatively, clearing all site data for RentalMath's domain (Application > Storage > Clear site data in Chrome DevTools) will remove the Service Worker, Cache Storage, and localStorage simultaneously. Clearing localStorage will delete any unsaved free-tier deal data.
See the Storage, Cookies & Caching Notice for instructions specific to each browser.
6Home-Screen Installation
RentalMath can be installed to your device's home screen or desktop as a PWA. The installation experience varies by device and browser:
- Chrome (Android/Desktop): An "Install" prompt or icon appears in the address bar when the PWA criteria are met. You can also use the browser menu (three-dot menu > "Install App" or "Add to Home Screen").
- Safari (iOS/iPadOS): Tap the Share button and select "Add to Home Screen." Note that iOS/iPadOS Safari has additional restrictions on PWA capabilities, including limited background sync support.
- Other browsers: Installation availability varies. Refer to your browser's documentation.
When installed as a PWA, RentalMath runs in a standalone window (without the browser's address bar) but remains a web application. It is not a native app and does not have access to native APIs beyond those available to web apps in your browser. Updates are delivered automatically via the Service Worker mechanism described in Section 2.
RentalMath