Real-time sync & presence

Aquilla is built for teams working at the same time. You see your colleagues’ work as it happens, and your own edits flow out continuously without any “sync now” button.

Presence: who’s editing what

When a teammate focuses a cell, you see it marked in real time — “Alice is editing this cell.” This presence information means you can spread out across a file without stepping on each other.

The signal comes from a short-lived focus lock each person’s editor claims on the cell they’re in. The lock releases automatically when they move away, go idle, or disconnect — so it never gets “stuck” on an abandoned cell.

How your edits travel

Aquilla uses a live connection (a WebSocket) to a per-project server component that handles presence, focus locks, and streaming edits. If your browser or network can’t keep a live connection open, Aquilla falls back to a regular HTTP path so you can keep working — just with slightly less immediacy.

Either way, your edits are optimistic: they’re saved to your local outbox immediately and reconciled with the server as soon as it confirms them. A short network drop won’t cost you any work.

Reading the sync status

A status indicator in the workspace tells you where things stand:

• Synced — everything you’ve written has reached the server;
• Queued (N) — you have edits saved locally, waiting to send;
• Sync backlog / failed — something is stuck retrying and may need a moment or a reconnect; and
• offline — no connection right now; edits are safe in your outbox and will send when you’re back.

If two people edit the same cell

Presence and focus locks make collisions unlikely. If two edits to the same cell do happen (for example, both made offline), Aquilla doesn’t try to merge the text — the first edit to reach the server becomes current, and the other is preserved in the cell’s history. Nothing is lost.