/ documentation
Download

Sync

Svodly works fully offline — the cloud is only needed if you have several devices, shared access to a book, or want a backup. The only cloud is the Svodly Cloud.

Svodly.ru
View
Computer: “Sync” → “Sign in” → signing in to the Svodly Cloud → the books go to the cloud with an “X / Y” counter → “Synced”. On the right — “Devices”, “What we sync” and “Where else to open your book”; “Refresh now” runs an exchange by hand.
Phone: “Settings” → “Connect to the cloud” → “Sign in” → the account’s books load over the Summary. In the profile — “Devices”: “This phone” and the computer you are already signed in on.
Third-party clouds (Yandex.Disk, Google Drive, WebDAV, Dropbox) are not supported for syncing: they have no access-control system at the Svodly level, which is needed for working together and keeping control over your data. More on why it works this way.

What the cloud gives you

On desktop and mobile the app works in full without the cloud — the whole book is stored locally. The web version inherently requires an account (it is a service running on a server).

Connect the Svodly Cloud

  1. On a computer, open “Sync” — there is no separate connect button, the sign-in form sits right on the screen: the “Sign in” and “Create account” tabs. On the phone — Settings → Connect to the cloud.
  2. Sign in with an existing account or sign up: email and password and the Sign in to Svodly Cloud or Create account button (sign-up is confirmed with a 6-digit code in an email). In the Russian interface you can also sign in with one tap via Yandex ID or VK ID.
  3. After you sign in, Svodly will send your local book to the cloud and turn on sync. The first push takes a few seconds for a typical book.

On the web there is nothing to connect: at app.svodly.ru you sign in to your Svodly Cloud account before the book even opens, and the “Sync” screen shows the cloud already connected.

More about the account, password recovery and deletion on the “Svodly Cloud account” page.

How it works

Svodly syncs not as a “whole file” but as small events: every create, change or delete is a separate record. Other devices apply these events on their side. Order and conflicts are resolved deterministically (hybrid logical clocks, “the last edit of a field wins”) — every device arrives at the same value. Edits of different fields of one record don't get in each other's way: change a transaction's category on one device and its amount on another, and after sync it has both edits.

If the same field was changed on two devices almost at once, the app applies the latest edit and shows a “sync conflict needs your decision” notice in the Sync section (on the phone — in the profile, in the “Sync” group). Review lists both versions of each field: Keep this one confirms the applied version, Restore this one brings back the other (on the phone — Keep and Restore). The choice is shared: the card disappears on your other devices and for the book’s members after they sync. If the conflict has already been resolved on another device, the app says so and shows the current value.

Computer: one transaction’s amount was changed both here and on the phone. After a sync — the conflict notice → “Review” → “Transaction · Amount”: the applied and the rejected versions with their authors → “Restore this one” → the restored amount in “Transactions”.
Phone: “···” → “Settings” with an attention dot → profile → “Sync conflicts” → “Review” → “Restore” on the rejected version → “All conflicts resolved”; the restored amount in “Transactions”.

While an exchange is running, the “Sync” screen on the computer and on the web shows its progress: the stage (“Pushing changes”, “Receiving data”), a bar and an “X / Y” counter — how many events have been sent or applied out of how many. A large book goes out in batches, and the counter grows with them.

What we sync: which books go to the cloud

The cloud is switched on per book, not for everything at once. On a computer and on the web the list of books is the “What we sync” card on the “Synchronization” screen. A book row is built like a device row: an icon plate (in the brand color for a synced book, neutral for a “this device only” book), the name and the status under it:

The controls live in the row’s ⋯ menu: Turn sync on / Turn off on this device, below a separator Publish to cloud (for the book owner only), and last, in red, Delete from cloud for the owner or Leave book for a member. Every item says what it will do. The menu is keyboard-navigable and closes on Esc.

The “restored from a backup”, “divergence” and “access lost” plates can be dismissed with a cross until the end of the session; the status in the row stays — no information is lost.

A phone has no separate “What we sync” list: there all books are synced, and a book created while the cloud is connected goes there right away. A book started on another device shows up on the phone by itself — after a sync, when you return to the app or when you open “Books”.

“What we sync”: a status under every book → the row’s “⋯” menu: “Turn off on this device” (“The cloud copy and your other devices stay as they are”), “Publish to cloud”, “Delete from cloud” → “Turn off on this device” pauses the book → “Turn sync on” — “Syncing” again.
The phone has no “What we sync” list: with the cloud connected, every book is synced.
Мобильный

Devices and sessions

The “Sync” section shows the list of devices connected to your account. Any session can be revoked — the device will lose access to the cloud (for example, if you sold a laptop or lost a phone). The local copy of the book on the revoked device stays, but stops syncing.

At the bottom of the same column sits the “Where else to open your book” card. It is a reminder of what Svodly runs on besides your current device: a computer (Windows, macOS, Linux and Astra Linux), a phone (Android and iPhone) and the browser (app.svodly.ru) — the platform you are on right now is marked “you're here”. The button leads to the download page with every version. On the phone the same block appears on the cloud connection screen and under the device list in your profile.

What goes to the cloud

The book's contents — in their original form, protected on our side by disk and database encryption (at-rest at the infrastructure level). Traffic runs over TLS 1.3. This is not end-to-end encryption: on our server engineers can technically see the data during service operations (migrations, diagnostics), but do not do so without your consent.

Attached files (receipt photos, PDFs) do not go to the cloud yet — only their metadata syncs between devices, while the file itself stays local. More on the security model on the “Security” page.

The “Update the app” notice

The devices of one book don't have to be on the same version: a phone updates through the app store, a computer on its own cycle. Usually that is fine. But if another device is already writing the book in a newer format while this one is not, some of the changes simply won't reach it.

In that case Svodly says so up front, in one line: “Update the app: another device is writing this book in a newer format, and some changes will not reach this one.” The notice lives on the “Sync” screen (on the computer and on the web) and as a banner in the “Sync” group of the profile (on the phone).

If sync isn't running

Open “Troubleshooting” — it covers the typical causes (an expired session token, no network) and how to work around them.

Where to go next