Offline Mode

Last updated: 2025-11-09

Shop anywhere, anytime—even without internet. ListAIse is built with an offline-first architecture that keeps your lists accessible and fully functional whether you're in a basement store, rural area, or airplane mode.

Local Storage

All data on device

Auto Sync

When online returns

Full Features

All core functions

No Data Loss

Changes preserved

Offline-First Architecture

ListAIse is designed from the ground up to work seamlessly offline. Unlike many apps that require constant internet connectivity, ListAIse stores all your data locally on your device using Hive—a fast, lightweight, and secure local database.

What This Means for You

Always Accessible: Your lists work perfectly in grocery store basements, parking garages, rural areas, or on flights
Lightning Fast: No network latency—all operations happen instantly on your device
Battery Efficient: Local storage uses less power than constant cloud communication
Data Privacy: Your data stays on your device until you're ready to sync

Technical Note

ListAIse uses Hive, a pure Dart NoSQL database optimized for mobile devices. Hive provides blazing-fast read/write operations with minimal memory overhead, making it perfect for offline-first applications.

Diagram showing ListAIse offline-first architecture with local Hive storage and cloud sync — Offline-first architecture: Local storage syncs to cloud when connectivity is available

How Offline Mode Works

Understanding how ListAIse manages data offline helps you use the app confidently, even in challenging connectivity situations.

The Offline-Sync Cycle

Initial Data Download

When you first install ListAIse and sign in, all your lists and items download from Firebase Firestore to your device's local Hive database. This creates a complete offline copy.

Offline Operations

While offline, every action you take (adding items, checking off purchases, creating lists, editing details) writes to local storage immediately. Changes are tagged with timestamps for later synchronization.

Change Queue

Offline changes are stored in a pending sync queue. This queue preserves the order of operations to ensure data integrity when syncing.

Connectivity Detection

ListAIse continuously monitors network status. When connectivity returns, the app automatically detects it and initiates synchronization.

Automatic Sync

The sync engine uploads pending changes to Firestore in the correct order, resolves any conflicts (see Conflict Resolution), and downloads updates from other devices.

Confirmation

Once sync completes, you'll see a brief confirmation notification. Your local data and cloud data are now identical, ready for the next offline session.

Sync Timing

Sync happens automatically when connectivity returns, but you can also trigger manual sync from Settings → Sync Now. Typical sync times are under 5 seconds for most users.

What You Can Do Offline

Almost every core feature of ListAIse works flawlessly offline. Here's a comprehensive list of available offline capabilities:

List Management

✓ Create new lists
✓ Edit list names and details
✓ Delete or archive lists
✓ Pin/unpin lists
✓ Change list colors and icons
✓ Duplicate lists

Item Operations

✓ Add items to lists
✓ Check off items
✓ Edit item names and quantities
✓ Delete items
✓ Reorder items (drag-and-drop)
✓ Add notes to items

Organization

✓ Sort lists (all options)
✓ Filter items
✓ Switch views (list/grid)
✓ Search lists and items
✓ Categorize items
✓ Set priorities

Settings & Preferences

✓ Change app theme
✓ Adjust settings
✓ View statistics
✓ Access help docs (cached)
✓ Modify notifications
✓ Update profile info

Pro Tip

Most users don't even notice when they're offline! ListAIse's offline experience is so seamless that the only indication is the small offline indicator in the status bar.

Offline Limitations

While ListAIse provides extensive offline functionality, some features require internet connectivity due to their cloud-dependent nature:

AI Features

✗ Voice input processing
✗ Recipe import from URLs
✗ AI recipe parsing
✗ Smart suggestions
✗ Price estimation (Premium)

These features use Google Gemini AI which requires cloud processing

Collaboration

✗ Real-time updates from others
✗ Sharing new lists
✗ Inviting collaborators
✗ Viewing who's online
✗ Live typing indicators

Your changes will sync and merge when connectivity returns

Account Operations

✗ Sign up / Sign in
✗ Password reset
✗ Email verification
✗ Account deletion
✗ Subscription changes

Authentication requires Firebase connection

Media & External

✗ Receipt scanning (Premium)
✗ Photo uploads
✗ Fetching web images
✗ Export to cloud services
✗ Store map downloads

Media operations require cloud storage access

Queued Actions

If you attempt an online-only action while offline (like voice input or recipe import), ListAIse will notify you and offer to queue the request for automatic execution when connectivity returns.

Automatic Synchronization

When your device reconnects to the internet, ListAIse automatically syncs all offline changes with the cloud. The sync process is intelligent, efficient, and designed to preserve data integrity.

Sync Triggers

Synchronization automatically starts when:

Network connectivity is restored after being offline
You open the app with an active internet connection
You manually trigger sync from Settings → Sync Now
You switch from airplane mode to normal mode
App returns to foreground after being backgrounded

What Gets Synced

Upload to Cloud

All changes you made offline: new lists, added/edited items, checked-off items, deleted items, setting changes, profile updates

Download from Cloud

Changes from other devices or collaborators: new shared lists, items added by family members, updates to shared lists, deletions by others

Sync Status Indicators

Syncing

Changes are currently uploading or downloading

Up to Date

All changes synced, local and cloud match

Offline

No connection, changes will sync later

Conflict Resolution

When you edit a shared list offline while someone else edits it online, conflicts can occur. ListAIse uses intelligent conflict resolution to merge changes automatically whenever possible.

How Conflicts Are Handled

✓ Automatic Resolution (Most Common)

90% of conflicts resolve automatically using these rules:

• Different items edited → Both changes kept
• Item added by multiple people → All items kept (no duplicates)
• One person checks off item, another edits it → Both changes applied
• Non-overlapping edits to same list → Changes merged

⚠ Manual Resolution Required (Rare)

In rare cases, you'll need to choose which version to keep:

• Same item edited differently by two people
• List name changed by multiple collaborators
• One person deletes item, another edits it

You'll see a conflict resolution dialog showing both versions and can choose which to keep or merge both changes manually.

Last-Write-Wins Strategy

For simple conflicts, ListAIse uses a "last-write-wins" approach based on server timestamps:

1When sync detects a conflict, it compares server timestamps
2The most recent change (by actual time, not sync time) takes precedence
3Overridden changes are saved to conflict history for 30 days (Premium)

Minimizing Conflicts

To reduce conflicts when sharing lists, communicate with collaborators before making major changes offline. For real-time collaboration, stay online when possible.

Connection Status Indicators

ListAIse provides clear visual indicators of your connection status and sync state throughout the app:

Status Bar Indicator

The top status bar shows your current connection state:

Online

Connected and synced

Offline

No connection - changes will sync later

Syncing

Uploading/downloading changes

Pending Changes Badge

When offline, a small badge shows the number of pending changes waiting to sync. Tap it to view details of what will sync when connectivity returns.

Item Indicators

Items modified offline show a small dot indicator until successfully synced to the cloud.

Offline Mode Best Practices

Follow these tips to get the most out of ListAIse's offline capabilities:

Pre-Download for Known Offline Periods

Before going somewhere with poor connectivity (flights, rural areas, basements), open ListAIse while online to ensure all recent data is downloaded and cached.

Regularly Sync on Good Connections

When you have WiFi, let the app sync fully before going offline again. This minimizes conflict potential and ensures you have the latest shared list updates.

Communicate with Collaborators

If you're about to make significant changes to a shared list while offline, let your collaborators know to avoid simultaneous conflicting edits.

Monitor Sync Status

Periodically check the sync status indicator. If you notice pending changes piling up, find a WiFi connection to sync before continuing heavy offline usage.

Be Cautious with Deletions

Deleting lists or many items while offline can cause confusion if collaborators are simultaneously editing. Consider archiving instead of deleting when offline.

Leverage Battery Savings

Offline mode uses significantly less battery. If you're running low on power during shopping, enable airplane mode to extend battery life while using ListAIse.