Offline mode

Scripvio is built offline-first: most of your personal work (notes, journal, tracking) can continue without a network. Data is saved on the device first, then synced to your account when you are back online.

This guide explains what works offline, what needs a connection, and how to read the app banners.

→ Synchronization · Offline FAQ

Offline-first principle

flowchart LR
  U[You] --> L[Local SQLite storage]
  L --> Q[Queue]
  Q -->|Network OK| S[Scripvio server]
  S --> L

Step	Where
Input	Immediate on the phone
Queue	Creates, edits, deletes waiting to send
Upload	Automatic when network returns

You usually do not need to tap a “Sync” button: the app tries to send as soon as connectivity is back.

Status banner (main indicator)

A compact banner may appear at the top of several screens (especially Create, Library, note/journal editors) when the network or sync requires it.

Message (app label)	Meaning	Color / icon
Syncing with server…	Upload in progress	Primary, sync icon
No connection. Your changes are saved on this device…	Offline — local work OK	Warning, cloud off
Changes are waiting to sync…	Online but queue not empty	Secondary
Sync failed. Your changes remain on this device…	Last upload failed — automatic retry	Error

Display priority: syncing → offline → failed → pending.

→ Synchronization

What you can do offline

Notes (drafts)

Action	Offline
Create a note	✅ (temporary id `local_…`)
Edit title, sections, content	✅ (local autosave)
Add / reorder sections	✅ (`local_section_…` if needed)
Structured Bible references	⚠️ Limited — Bible metadata needs online
Free-text passage in the note	✅
Publish	⏳ Publish queued (offline). — applied on sync
Export PDF	❌ Connection + note must not be `local_` — see below

Take sermon or study notes — offline and synced. (Create hub)

→ Notes — draft and publish

Journal (drafts)

Action	Offline
Create / edit an entry	✅
Moods, tags, text	✅
Publish	⏳ Publish queued (offline).
Structured Bible references	⚠️ Bible references will be available once the entry is synced…
Link Tracking activity	❌ Linking requires an internet connection.

→ Journal — draft and publish

Library (published)

Action	Offline
Read already synced notes / journal	✅ (local cache)
List, search, favorites	✅ on cached data
New content from another device	❌ until sync + refresh
New version… / published edit	Depends on cache — publish often queued

Offline — totals only include notes available on this device. (Create list counters)

→ Library

Tracking

Action	Offline
Add reading / prayer / meditation	✅ (local entries pending)
Dashboard	Partial — calendar: Month view is approximate offline…
Link to journal	❌ after create — offline message possible

→ Tracking

Home

Element	Offline
Resume local drafts	✅
Note stats	Offline — no local stats yet possible
Dashboard hint	Some data needs a connection (search, up-to-date journal).

Connection required (or strongly recommended)

Need	Why
First sign-in / account creation	Server authentication
Bible search (new search)	Bible API — You are offline — a new Bible search is not available…
Read passage (sheet)	Connection required to show this passage.
Note PDF export	A connection is required to export the PDF. + note not `local_`
Profile (name, photo, account language)	Offline — profile edits are disabled
Account notifications (toggles)	Often greyed out offline
Add verse from Search to note/journal	API
Delete account	Disabled offline

Search: local cache

Offline, you can still open the last search stored on the device: Showing the last search saved on this device.

→ Bible search

PDF export and sync

If changes are not uploaded yet:

Sync before export — Some changes are not synced yet. Sync now to include the latest version in the PDF?

Button	Effect
Sync	Runs the queue then export
Cancel	Aborts export

Save or sync the note before exporting. if the note is still local_….

Temporary ids (`local_…`)

Until the server confirms a create, Scripvio uses local ids:

Prefix	Example use
`local_…`	Note created offline
`local_section_…`	New section
`local_verse_…`	Pending Bible reference

After a successful sync, the app replaces them with server ids — you keep working in the same screen.

Sign out while offline

If you sign out without network, Scripvio warns that local data (including unsynced notes) may be removed from the device.

→ Profile — sign out

Good practices

Tip	Reason
Wait for Syncing… banner to finish before an important PDF	PDF uses server version
Avoid editing the same note offline on two devices in parallel	Last upload may win
Keep the app open a few seconds after Wi‑Fi returns	Lets the queue drain
Check the banner before a service with no network	Know if you rely on 100 % local data

Common issues

Symptom	Explanation	Action
Library feels “stuck”	Local cache	Reconnect, refresh (pull)
Published note missing online	Publish still in queue	Wait for sync
Bible reference greyed out	No offline metadata	Go online or use free text
Error banner persists	Unstable API or network	Retry later; content stays local
PDF refused	`local_` or no network	Sync then export again

FAQ

Can I use Scripvio on a plane without preparing?
Yes to create and edit; Library only shows what was already on the device.

Is offline unlimited in time?
Data stays on the device until sync or sign-out (which may clear local data).

Does Scripvio work without an account offline?
No — you need to have signed in at least once for session + cache.

Topic	Link
Sync details	Synchronization
FAQ	Offline and sync
Notes	Notes — overview
Support	Contact us