Help Center Your Files & Sync Sync across devices

Your Files & Sync

Sync across devices with iCloud or Dropbox

There is no visualOS cloud — and that’s a feature. Your devices stay in sync by all pointing at the same folder in your cloud: iCloud Drive, Dropbox, or any service that syncs a folder to disk.

More in Your Files & Sync
  1. How storage works
  2. canvas-data.json & board.json
  3. Where are my notes?
  4. Sync across devices
  5. The “Keep Downloaded” fix
  6. Version history
  7. Backups (export & import)
  8. Conflicts & merging
  9. The New Items pool
  10. Editing files outside the app
  11. Disconnect or move the folder

How it works

You connect a folder that lives inside your cloud drive. visualOS writes your workspace into it; your cloud service copies it to your other machines; visualOS on those machines reads it back. The app checks for a newer version every time it starts or comes back to the foreground — so the normal rhythm is: finish on device A, open the app on device B, and the new state is just there.

Setting it up

  1. Create one folder in your cloud

    For example iCloud Drive/visualOS or Dropbox/visualOS. One folder — not one per device.

  2. Connect it on your first device

    Settings → Folder & Workspace → Connect. Your existing canvas is written into the folder.

  3. Connect the same folder on every other device

    Same steps there. visualOS will detect the existing data and offer to load it — accept, and the device joins the party.

  4. Set the folder to “Keep Downloaded” on every device

    This tells your cloud to keep real copies on the device instead of placeholders. It’s the difference between sync that feels instant and sync that seems broken — step-by-step here.

What to expect

  • It’s not real-time collaboration. visualOS is a personal tool: work on one device, pick up on another. Changes travel when your cloud syncs the files — usually seconds, sometimes longer on slow connections.
  • Offline is fine. Edit away without a connection; your changes are written to the folder and your cloud forwards them when it’s back online.
  • Both devices edited at once? visualOS merges your changes item by item, and keeps both versions when the exact same element was edited on both sides. Nothing is lost — details in When two devices edit at once.

Which cloud services work?

iCloud Drive (the natural choice on Apple devices), Dropbox, and generally anything that shows up as a normal folder on your disk — OneDrive, Google Drive for desktop, Syncthing, a NAS folder. On iPhone/iPad the native app connects to iCloud Drive folders via the system picker.

The #1 support question

“I made changes on my iPad but they don’t show on my Mac.” In almost every case the folder isn’t set to Keep Downloaded, so one device is looking at a stale placeholder. Fix it in one minute.

Didn’t find what you need?

Tell us what’s missing — feature ideas and bug reports land directly on our roadmap. Or just open the canvas and poke around; you can’t break anything.