Offline Mode

Krokanti Notes is a Progressive Web App with full offline support. You can read and edit notes without an internet connection — changes sync automatically when you reconnect.

How Offline Mode Works

When you open Krokanti Notes, your notes are stored locally in your browser's IndexedDB (a built-in browser database). This local copy lets you:

• Read all your notes without internet
• Create new notes
• Edit existing notes
• Move notes, add tags, pin/unpin

Changes made offline are queued and sent to the server as soon as your connection returns.

Going Offline

There's nothing to configure — offline mode is automatic. When you lose your connection:

• A small indicator may appear noting you're offline
• The app continues to work normally
• Save attempts are queued (you'll see the saving indicator but no error)
• Notes created or edited offline are marked as "pending sync"

Reconnecting

When your connection returns:

1. All queued saves are sent to the server automatically
2. The server sends back any notes that were changed on other devices
3. Conflicts (if any) are flagged with a banner in the editor

Secure Notes and Offline

Locked secure notes (PIN-encrypted notes that are currently locked) cannot be synced while offline if they have unsaved changes. Here's why: the app can't decrypt them without your PIN to check what changed, so it waits.

When you reconnect and unlock the secure note by entering your PIN, the pending changes sync immediately.

App Shell Caching

The service worker caches the app shell (HTML, JavaScript, CSS) so the app loads even with no internet. The first load requires a connection; subsequent loads work offline.

Limitations

• Images: images from Cloudflare CDN are not cached locally — they won't load offline (the text content of the note is still available)
• New account: first sign-in requires an internet connection
• Shared notes: changes to notes shared with you by others only appear after syncing with the server

Clearing Offline Data

If you want to clear the locally cached notes (e.g., switching accounts or clearing space):

1. Open your browser's DevTools → Application → Storage
2. Find IndexedDB → clear the Krokanti Notes database
3. Reload the page — notes re-sync from the server on the next load

Alternatively, clearing all site data for notes.krokanti.com in your browser settings achieves the same result.