iCloud Integration

Diagrammix3 integrates with iCloud Drive, allowing you to sync your diagrams across all your Mac devices automatically.

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 10.15 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

Default Location

You can set iCloud Drive as your default save location:

1. Open Diagrammix3 preferences
2. Find the default save location setting
3. Choose iCloud Drive

Accessing Documents Across Devices

Once saved to iCloud Drive:

1. Open Diagrammix3 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 Diagrammix3
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: Create a Diagrammix folder in iCloud Drive
3. Regular backups: Export important diagrams locally as backup
4. Check sync before closing: Ensure changes are synced before shutting down