iCloud

If you're in the Apple ecosystem, iCloud Drive makes it easy to keep your notes synced across all your devices.

Since Octarine just saves your notes as regular markdown files, you can drop your workspace right into iCloud Drive and let Apple handle the rest.

Setting Up iCloud Sync

Getting started is quick:

Open Octarine and create a new workspace (or open an existing one)
Navigate to iCloud Drive when choosing where to save — you'll usually find it under Locations in the file picker sidebar
Create or select a folder for your workspace
Start working — Octarine will now save everything to that iCloud folder, and your notes sync automatically to any device signed in with your Apple ID

How It Works

Octarine doesn't do anything special with iCloud—it just reads and writes files to your iCloud Drive folder like any other app.

When you make a change, it's saved to iCloud immediately and appears on your other devices within seconds. You can edit a note on your Mac and pick up where you left off on your iPad or iPhone.

If you're offline, don't worry. Your notes are cached locally, so you can keep working.

Once you're back online, everything syncs up automatically. And if you've got large images or attachments in your workspace, iCloud prioritizes them based on what you're actively using.

When Conflicts Happen

Edit the same note on two devices while offline? iCloud creates conflict copies with timestamps in the filename.

You'll see both versions in Octarine's file tree. Just review them, merge any changes you want to keep, and delete the conflict copy.

The file tree updates automatically once you're done.

Things to Keep in Mind

The first time you open a large workspace, it might take a bit for everything to sync—especially if you've got a lot of attachments.

After that, though, changes usually show up on other devices within seconds.

Just make sure you have enough iCloud storage available and a decent internet connection.

When Sync Isn't Working

If your notes aren't syncing, here's what to check:

Check iCloud Drive is enabled in System Settings
Verify storage space — if you're out of space, nothing new will sync
Force a sync by right-clicking your workspace folder in Finder and selecting "Download Now"
Refresh the file tree by clicking the refresh icon in Octarine's toolbar
Confirm internet connection is active

Platform Notes

On macOS, you get full two-way sync with immediate updates.

If you need to check your notes from a browser, you can view them (but not edit) at icloud.com.