Offline Mode & Syncing

One of the most powerful features of CO2 Asset Management is offline support. You can keep working even when your internet connection is down. Everything syncs automatically when you reconnect.

Why Offline Matters

Imagine you’re on a job site with unreliable WiFi, or your internet drops in the middle of work. Without offline support, you’d lose all your changes. With it, you can keep going and sync later:

• No data loss - Changes are saved locally immediately
• No interruption - Work continues as if you’re online
• Automatic catch-up - Everything syncs when connectivity returns
• Peace of mind - Never worry about losing your work

How Offline Mode Works

What Works Offline

Once you’ve loaded your estates and floor plans, these activities work fully offline:

• ✅ View all previously loaded estates, sites, and floor plans
• ✅ Add new assets to floor plans
• ✅ Move assets to new positions
• ✅ Delete assets
• ✅ Draw boundaries
• ✅ Add annotations
• ✅ Make changes to existing data
• ✅ Undo and redo changes
• ✅ Switch between floors and buildings

Everything looks and works the same as when you’re online.

What Requires Connection

These features still need internet:

• ❌ Load new estates, sites, or buildings
• ❌ Upload new floor plan images
• ❌ Invite team members to an estate
• ❌ View real-time changes from teammates (you’ll see them after syncing)

If you try these without internet, you’ll see a helpful message explaining that connection is needed.

---

Sync Status Indicator

Look for the sync status indicator in the top-right area of the application (usually near the connection status):

Sync States

Icon	What It Means	What To Do
🟢 Green checkmark	Fully synced, all changes saved to server	Nothing - you’re good
🔄 Spinning arrow	Currently syncing changes	Wait - don’t close the app
🟠 Orange warning	Pending changes, not yet synced	Changes will sync when possible
🔴 Red error	Sync conflict or error	See “Sync Conflicts” below

Sync Progress

Hover over the sync indicator to see details:

• How many changes are pending
• When the last successful sync was
• Current upload/download status

Using Offline Mode Effectively

Going Offline Intentionally

If you know you’ll be offline:

1. Open the areas you’ll work on (so they’re cached)
2. Load the floor plans you’ll need
3. Continue working as normal when internet drops
4. Your changes will sync automatically when you reconnect

Checking Connection Status

You can usually see your connection status:

• Online indicator in the toolbar or header
• Notification when connection is lost
• Sync status icon showing what’s happening

Working in the Field

When you’re on a job site:

1. Load the estate and floor plan at the office (while connected)
2. Go to the job site offline
3. Add and move assets as you inspect
4. Drive back to the office to sync
5. Everything uploads automatically

Tip

Pro tip: Before going offline, load a few floor plans and review them. This ensures the images are cached and you won’t have to download them later.

---

Sync Conflicts

Occasionally you might encounter a sync conflict - this happens when:

• You made changes offline
• A teammate made different changes online at the same time
• When you reconnect, the system doesn’t know which version is correct

What You’ll See

A notification appears saying something like:

“Sync conflict detected on Estate A, Floor 3. Please review changes.”

How to Resolve

Most conflicts auto-resolve:

1. The system compares changes
2. Non-conflicting changes are merged automatically
3. You only see conflicts if the same asset was changed differently

If you see a manual conflict:

1. Click the notification to see the details
2. You’ll see both versions side-by-side
3. Choose which version to keep:
   • Your local changes (what you did offline)
   • The server version (what your teammate did)
4. Click Resolve to apply your choice
5. The change syncs and you’re back in sync

Caution

Resolving conflicts: Choose carefully - you’re picking which version becomes the official record. When in doubt, ask your teammate what they changed and why.

---

Offline in Different Scenarios

Scenario: Home Internet Drops

1. You’re working on your laptop
2. Internet stops mid-session
3. You keep working - no interruption
4. Internet comes back automatically syncs
5. No action needed from you

Scenario: Traveling to a Job Site

1. Load everything at home (estates, sites, floor plans)
2. Travel to a site with no WiFi
3. Work on multiple floors - everything works
4. Return to office, changes automatically sync
5. Your teammates see all updates within seconds

Scenario: Multiple People Editing

1. You and a teammate work on different assets (no conflict)
2. Both work offline on the same floor
3. When you both sync, both changes merge (no problem)
4. Everyone sees the complete picture

---

Troubleshooting

Sync seems stuck

If you see the spinning sync icon for more than a minute:

1. Check your internet connection
2. Try refreshing the page gently (don’t force close)
3. If it persists, close and reopen the application
4. Contact support if sync keeps failing

Changes aren’t syncing

First check:

• Are you still online? Look at the connection status
• Are there pending changes? Check the sync indicator

If still not working:

1. Refresh the browser page
2. Close other tabs using the app
3. Try a different network (WiFi to cellular, etc.)

Lost changes after going offline

All changes made offline should sync when you reconnect. If something seems missing:

1. Check the Undo & History log
2. Look for your changes in the timeline
3. If truly lost, contact support with the timestamp

Very rare: In extremely unusual cases (app crash, device loss), changes might not sync. Always verify important work is saved by refreshing.

---

Best Practices

Before Going Offline

• ✅ Load the floor plans you’ll work on
• ✅ Make sure the app is in a stable state (no sync errors)
• ✅ Have enough battery (syncing uses some power)
• ✅ Note what you plan to change (mental checklist)

While Offline

• ✅ Continue working normally
• ✅ Check sync status occasionally (but don’t obsess)
• ✅ Keep app in foreground if possible (faster sync when back online)

When You Reconnect

• ✅ Let sync complete (look for green checkmark)
• ✅ Verify your changes appear
• ✅ Communicate with teammates if there were conflicts

If You See an Error

• ✅ Note the error message
• ✅ Try refreshing
• ✅ Contact support if it persists

---

Technical Details (For the Curious)

How It Works

1. Local Storage - Changes are saved to your device immediately
2. Queuing - Changes wait in a queue until connection returns
3. Sync - Changes upload to server when possible
4. Merge - Server applies changes in order received
5. Confirmation - App confirms sync succeeded with green checkmark

What Gets Synced

• Asset positions and properties
• Boundary changes
• Annotations and notes
• Deletions
• Metadata updates
• Bulk operations

Sync Frequency

• Real-time when online - Changes sync as soon as possible
• On reconnect - If offline, everything queues then uploads
• Periodic retry - Failed syncs retry automatically

---

Limitations & Known Issues

Storage

On mobile devices, offline storage is limited by available device space. Very large floor plans might not cache completely.

Very Long Offline Periods

If you’re offline for extended periods (days), sync might take longer. Plan accordingly for job site visits.

Team Notifications

Real-time notifications don’t work offline - you’ll see them all at once when you sync.

---

What’s Next?

• Undo & History - Audit trail of all changes
• Notifications - Stay informed after sync
• Floor Plans - Start working with your floor plans