Offline Mode

9.1 Understanding Offline Mode

EasyPrompter supports offline access for viewing and (with paid plans) editing scripts.

Free Plan:

  • Read-only offline access
  • Can view cached scripts
  • Cannot create or edit scripts offline

Creator/Studio Plans:

  • Full offline access
  • Can view and edit cached scripts
  • Cannot create new scripts while offline (create requires an online connection)
  • Collections available offline

9.2 Enabling Offline Mode

Automatic Caching

  • Scripts you view are automatically cached
  • Smart Precaching: Your Recent Scripts and Collections are proactively cached in the background, ensuring your most important work is available even if you haven't opened it recently.
  • Caching happens in background
  • No manual action required

Manual Caching

  1. View scripts while online (they're cached automatically)
  2. View collections while online
  3. Data is stored in browser's IndexedDB
  4. Available offline after caching

Edge Cases:

  • Very large scripts may take time to cache
  • Browser storage limits apply (typically 50MB-1GB depending on browser)
  • Clearing browser data clears offline cache

9.3 Using Offline Mode

When Offline

  1. App detects you're offline
  2. Offline Mode indicator appears
  3. You can access cached scripts and collections
  4. Free plan: Read-only access
  5. Paid plans: You can edit cached scripts (edits are saved locally and sync when you reconnect)

Offline Indicators

The app shows different indicators based on your connection status:

Bottom-Right Indicator (paid plans):

  • Yellow "Offline Mode": Shows when offline
    • Displays number of cached scripts available
    • Shows days remaining if approaching grace period limit
  • Green "Back Online": Shows briefly when connection is restored

Read-Only Indicator (Free plan):

  • "Read Only" badge appears on scripts
  • Cannot edit even cached scripts

Grace Period (Paid Plans)

Paid plans include an offline grace period:

  • Duration: 7 days of offline access
  • Countdown: When approaching limit, shows "X days remaining"
  • Expiration: After grace period expires, access is blocked until you reconnect
    • A full-screen modal appears requiring internet connection
    • Click "Retry Connection" to reconnect and restore access

Edge Cases:

  • If script isn't cached, it won't be available offline
  • Offline edits sync automatically when you're back online (best-effort)
  • If the script changed on the server while you were offline, you may be prompted to choose which version to keep
  • Editor drafts are stored locally while you work but do not appear as separate scripts in the script list
  • Network reconnection is detected automatically
  • Changes made offline sync when you reconnect
  • Grace period resets each time you connect to the internet
  • The offline indicator doesn't appear for the first 30 seconds after page load (to prevent false positives)

9.4 Managing Offline Cache

Viewing Cache Status

  1. Go to Settings → Offline Cache
  2. See cached scripts count
  3. See cache size
  4. See last sync time

Clearing Cache

  1. Go to Settings → Offline Cache
  2. Click "Clear Cache"
  3. Confirm clearing
  4. All cached data is removed

Edge Cases:

  • Clearing cache doesn't delete scripts from server
  • You'll need to view scripts again to cache them
  • Cache is per-organization (switching orgs loads different cache)

9.5 Syncing Changes

When You Reconnect

  1. App detects you're back online
  2. "Back Online" message appears
  3. Offline changes sync automatically
  4. You can create/edit scripts normally

Sync Conflicts

  • Rare, but can occur if script was edited by another user while you were offline
  • You'll see a conflict resolution dialog
  • Choose which version to keep

Edge Cases:

  • If sync fails, you'll see an error message
  • You can retry sync manually
  • Very large changes may take time to sync