iCloud Integration

Diagrammix integrates with iCloud Drive, so you can keep your diagrams in sync across all your Macs.

iCloud Drive Overview

When you save diagrams to iCloud Drive:

• Files are automatically synced to iCloud
• Access your diagrams from any Mac signed into your Apple ID
• Files are backed up to iCloud
• Changes sync automatically when connected to the internet

Enabling iCloud

System Requirements

• macOS 13.0 or later
• Active Apple ID
• iCloud Drive enabled in System Settings

Check iCloud Status

1. Open System Settings (or System Preferences on older macOS)
2. Click Apple ID
3. Select iCloud
4. Ensure iCloud Drive is enabled

Saving to iCloud

Save Dialog

When saving a new document:

1. Go to File → Save or press Cmd+S
2. In the save dialog, click the location dropdown
3. Select iCloud Drive
4. Navigate to your preferred folder
5. Click Save

The Diagrammix Folder

Diagrammix has its own Diagrammix folder in iCloud Drive. Choose it in the save dialog to keep all your diagrams in one place.

Moving an Existing Document to iCloud

Use File → Move To... and choose iCloud Drive (or its Diagrammix folder). File → Rename... renames the document in place, and File → Duplicate makes a copy.

Autosave and Versions

Documents save automatically in place, and macOS keeps earlier versions. To go back to the last saved state, choose File → Revert to Saved.

Accessing Documents Across Devices

Once saved to iCloud Drive:

1. Open Diagrammix on any Mac signed into your Apple ID
2. Go to File → Open
3. Navigate to iCloud Drive
4. Select your diagram

Documents open with the latest synced version.

Sync Status

Checking Sync Status

In Finder, look for sync indicators next to files:

Force Sync

To ensure a file is synced:

1. Right-click the file in Finder
2. Select Download Now (if cloud icon visible)
3. Wait for the download to complete

Handling Sync Conflicts

If you edit the same document on two devices without syncing:

How Conflicts Occur

1. You open document on Mac A
2. You open the same document on Mac B (offline)
3. You make different changes on each Mac
4. Both Macs reconnect and try to sync

Resolving Conflicts

When a conflict occurs, iCloud creates a conflicted copy:

1. You'll see two versions of your file
2. One named normally, one with "conflicted copy" in the name
3. Open both versions
4. Manually merge changes or choose the correct version
5. Delete the unwanted version

Avoiding Conflicts

• Sync before editing: Ensure files are fully synced before working
• Sync after saving: Wait for the sync indicator to show complete
• One device at a time: Avoid editing the same file simultaneously

Working Offline

You can work offline with iCloud files:

1. Files you've opened recently are cached locally
2. Make changes while offline
3. Changes sync automatically when you reconnect

Making Files Available Offline

To ensure a file is always available:

1. Right-click the file in Finder
2. Select Download Now
3. The file will be kept locally

Storage Management

Checking Storage

1. Open System Settings → Apple ID → iCloud
2. View your storage usage
3. Click Manage for details

Optimizing Storage

macOS can automatically remove locally cached iCloud files when storage is low:

1. Open System Settings → Apple ID → iCloud
2. Enable Optimize Mac Storage

Note: This may require re-downloading diagrams when you need them.

Troubleshooting

Files Not Syncing

1. Check internet connection
2. Verify iCloud Drive is enabled
3. Check iCloud storage isn't full
4. Restart Diagrammix
5. Sign out and back into iCloud (last resort)

Slow Sync

• Large files take longer to sync
• Check your internet connection speed
• Wait for background syncing to complete

Missing Files

1. Check iCloud.com to verify file exists
2. Look in the "Recently Deleted" folder
3. Check other devices for the file

Tips

1. Name files clearly: Good names help identify files across devices
2. Organize with folders: Use the Diagrammix folder in iCloud Drive and create subfolders inside it
3. Regular backups: Export important diagrams locally as backup
4. Check sync before closing: Ensure changes are synced before shutting down