Skip to main content

​
Overview

Peanuts works offline! When you lose connectivity, your entries are safely stored on your device and sync automatically when you reconnect.
Offline mode requires installing Peanuts as a PWA for the best experience.

​
How It Works

1

Log as normal

Add entries via text, voice, or any input method while offline.
2

Entries are queued

Peanuts stores pending entries securely on your device using IndexedDB.
3

Auto-sync on reconnect

When internet returns, entries sync automatically in the background.
4

Confirmation

You’ll see a toast notification: “Synced X offline entries”

​
Offline Capabilities

​
What Works Offline

Instant Logs

Simple entries using local pattern matching (0 credits)

View Data

Access recently cached Helpers and entries

Queue Entries

Store entries to sync later

Navigate

Browse the app interface normally

​
What Requires Connection

AI Features

Ask Peanuts, complex routing, Smart Scan

Voice Transcription

Speech-to-text requires cloud processing

New Helper Creation

AI-generated Helpers need connectivity

Real-time Sync

Live collaboration updates

​
Pending Entries

When you have unsynced entries, you’ll see:
  • Badge count showing number of pending entries
  • Pending indicator in the app header
  • Queue icon to view pending entries

​
Viewing Pending Entries

  1. Tap the pending indicator or badge
  2. See a list of all queued entries
  3. Entries show their destination Helper
  4. Status shows “Pending sync”
Pending entries can be viewed but not edited. Once synced, they become normal entries.

​
Manual Sync

To force a sync attempt:
  1. Pull down to refresh on any screen
  2. Or go to Settings → Sync → Sync Now
This is useful if:
  • Automatic sync seems delayed
  • You want to confirm sync status
  • You’re about to close the app

​
Sync Behavior

​
Automatic Sync

  • Triggers when connectivity is restored
  • Runs in the background
  • Shows toast when complete
  • Retries failed entries automatically

​
Conflict Resolution

If the same entry was modified both offline and online:
  • Most recent change wins
  • Conflicts are rare in practice
  • No data is lost—older version is archived

​
Offline Duration

Peanuts stores offline entries indefinitely until synced. However:
  • Very old cached data may be cleared by the browser
  • For long offline periods, sync before clearing app data
  • The app preserves your queue across restarts

​
Best Practices

If you have pending entries, wait for sync to complete before closing Peanuts.
Simple pattern-matched entries work fully offline. Complex inputs queue for later processing.
Installing Peanuts provides better offline support than using the browser.
Don’t let too many entries queue up. Sync when you have connection.

​
Troubleshooting

  1. Check internet connection
  2. Try manual sync (pull to refresh)
  3. Restart the app
  4. Check if you’re logged in
  1. Check the pending queue
  2. Entries may have already synced
  3. Check the target Helper for synced entries
  1. Some entries may fail validation
  2. Check the error message
  3. The entry remains in queue for retry
  4. Contact support if issues persist

​
Technical Details

For developers and curious users:
  • Storage: IndexedDB for reliable local storage
  • Queue: FIFO (first-in-first-out) processing
  • Retry: Exponential backoff for failed syncs
  • Cache: Service Worker caches app assets

Install as App

Get the best offline experience

Instant Logs

Zero-credit logging that works offline