Skip to main content
Version: v2.10.0

Auto-Save and Periodic Sync

Overview​

Yeedu notebooks now include automatic saving and periodic synchronization features, ensuring your work is never lost. Changes are saved automatically at configurable intervals.

Auto-Save Features​

Automatic Saving​

  • Real-time Saving: Changes saved as you work
  • Periodic Sync: Automatic synchronization at intervals
  • Backup Recovery: Recover work from saved versions
  • No Manual Save Needed: Focus on your work, not saving

Save Indicators​

  • Saving...: Currently saving changes
  • ✓ All changes saved: All work saved successfully
  • ⚠️ Unsaved changes: Recent changes not yet saved

Configuring Auto-Save​

Enable Auto-Save​

  1. Open Notebook Settings (gear icon)
  2. Find Auto-Save section
  3. Toggle Enable Auto-Save on
  4. Choose save interval:
    • Fast: Every 30 seconds (default)
    • Standard: Every 60 seconds
    • Slow: Every 120 seconds
    • Manual: Save only when requested

Adjust Save Interval​

  1. In Notebook Settings
  2. Set custom interval in seconds
  3. Shorter interval = more frequent saves (uses more resources)
  4. Longer interval = less frequent saves (more data loss risk)

Save Location​

  • Notebook cells automatically saved to database
  • Cell content persisted
  • Execution state not saved (re-run after restart)
  • Versions kept for recovery

Markdown Cell Auto-Save​

Markdown cells are also auto-saved:

  • Edit markdown content
  • Changes saved automatically
  • Rich text formatting preserved
  • Links and images retained

Periodic Synchronization​

What Gets Synced​

  • Cell content (code and markdown)
  • Cell order and structure
  • Cell execution status
  • Notebook-level metadata
  • Custom parameters

Sync Behavior​

  1. Local Changes: Made in real-time in your browser
  2. Queue: Changes queued for synchronization
  3. Periodic Sync: Pushed to server at intervals
  4. Confirmation: Sync status shown in UI

Handling Conflicts​

If the same cell is edited in another session:

  • Last saved version wins
  • Notification of conflict appears
  • Option to reload and merge manually

Working Without Internet​

Offline Mode​

If connection drops:

  1. Changes buffered locally
  2. Continue editing normally
  3. Connection restored automatically
  4. Pending changes synced immediately

Offline Indicators​

  • No Connection: Red indicator
  • Syncing...: Yellow indicator
  • Synced: Green indicator

Manual Save Operations​

Force Save Now​

  1. Click Save button (if visible)
  2. Or use keyboard shortcut: Ctrl+S (Windows) / Cmd+S (Mac)
  3. Immediate save to server

Save with Message​

  1. Click Save with dropdown
  2. Add save note/message
  3. Helps track versions
  4. Useful before major changes

Version and Recovery​

Version History​

  1. Click Notebook menu
  2. Select Version History
  3. View all saved versions:
    • Timestamp
    • Last edited by
    • Save message (if any)

Restore Previous Version​

  1. Open Version History
  2. Click on previous version
  3. Preview changes
  4. Click Restore if satisfied
  5. Current notebook reverted

Compare Versions​

  1. Select two versions in history
  2. Click Compare
  3. See side-by-side diff
  4. Review changes before restoring

Auto-Save and Performance​

Impact on Notebook​

  • Minimal: Auto-save runs in background
  • Large Notebooks: Longer sync times (notebooks > 10MB)
  • Network: Slower internet = slower auto-save
  • Frequency: More frequent = higher resource usage

Optimization Tips​

  • Use larger save interval for very large notebooks
  • Reduce cell complexity to speed save
  • Clear output before saving large files
  • Archive old notebooks to improve performance

Troubleshooting Auto-Save​

Changes Not Saving​

  1. Check Save Status indicator
  2. Verify internet connection
  3. Check browser console for errors
  4. Try manual save (Ctrl+S)
  5. Reload notebook

Sync Failures​

  1. Verify connection to Yeedu server
  2. Check network firewall rules
  3. Review browser console logs
  4. Try disabling browser extensions
  5. Clear browser cache

Lost Work Recovery​

  1. Open Version History
  2. Find version before data loss
  3. Click Preview
  4. Verify content correct
  5. Click Restore

Best Practices​

Optimal Settings​

  • Use Fast (30 sec) for critical work
  • Use Standard (60 sec) for normal use
  • Use Manual only for quick tests
  • Always verify important changes are saved

Working in Teams​

  • Different users can edit different cells
  • Be aware of conflicts
  • Use descriptive save messages
  • Review version history frequently

Data Loss Prevention​

  • Use version history regularly
  • Save before major changes manually
  • Take snapshots of important notebooks
  • Archive notebooks regularly

See Also​

  • [Create Notebook](./Create notebook.md)
  • [Editor Pane](./Editor Pane.md)
  • [Notebook Types](./Notebook types.md)