Initial release: Workflow Snapshot Manager v1.0.0

Auto-capture workflow snapshots with per-workflow hash map, promise-based restore lock, custom naming, search/filter, theme-aware CSS, toast notifications, and native confirm/prompt dialogs. Includes README with SVG/PNG assets, MIT license, and ComfyUI registry publish action. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 17:31:32 +01:00
commit e1d63e58d6
13 changed files with 1256 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,123 @@
+<p align="center">
+  <img src="assets/banner.png" alt="Workflow Snapshot Manager" width="100%"/>
+</p>
+
+<p align="center">
+  <a href="https://registry.comfy.org/publishers/ethanfel/nodes/comfyui-snapshot-manager"><img src="https://img.shields.io/badge/ComfyUI-Registry-blue?logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZD0iTTEyIDJMMyA3djEwbDkgNSA5LTVWN2wtOS01eiIgZmlsbD0id2hpdGUiLz48L3N2Zz4=" alt="ComfyUI Registry"/></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"/></a>
+  <img src="https://img.shields.io/badge/version-1.0.0-blue" alt="Version"/>
+  <img src="https://img.shields.io/badge/ComfyUI-Extension-purple" alt="ComfyUI Extension"/>
+</p>
+
+---
+
+**Workflow Snapshot Manager** automatically captures your ComfyUI workflow as you edit. Browse, name, search, and restore any previous version from a sidebar panel — all stored locally in your browser's IndexedDB.
+
+<p align="center">
+  <img src="assets/sidebar-preview.png" alt="Sidebar Preview" width="300"/>
+</p>
+
+## Features
+
+- **Auto-capture** — Snapshots are saved automatically as you edit, with configurable debounce
+- **Custom naming** — Name your snapshots when taking them manually ("Before merge", "Working v2", etc.)
+- **Search & filter** — Quickly find snapshots by name with the filter bar
+- **Restore or Swap** — Open a snapshot as a new workflow, or replace the current one in-place
+- **Per-workflow storage** — Each workflow has its own independent snapshot history
+- **Theme-aware UI** — Adapts to light and dark ComfyUI themes
+- **Toast notifications** — Visual feedback for save, restore, and error operations
+- **Concurrency-safe** — Lock guard prevents double-click issues during restore
+- **Zero backend** — Pure frontend extension, no server dependencies
+
+## Installation
+
+### ComfyUI Manager (Recommended)
+
+Search for **Workflow Snapshot Manager** in [ComfyUI Manager](https://github.com/ltdrdata/ComfyUI-Manager) and click Install.
+
+### Git Clone
+
+```bash
+cd ComfyUI/custom_nodes
+git clone https://github.com/ethanfel/Comfyui-Workflow-Snapshot-Manager.git
+```
+
+Restart ComfyUI after installing.
+
+## Usage
+
+### 1. Open the Sidebar
+
+Click the **clock icon** (<img src="https://img.shields.io/badge/-pi pi--history-333?style=flat" alt="history icon"/>) in the ComfyUI sidebar to open the Snapshots panel.
+
+### 2. Snapshots are Captured Automatically
+
+As you edit your workflow, snapshots are saved automatically after a configurable delay (default: 3 seconds). An initial snapshot is also captured when the workflow loads.
+
+### 3. Take a Named Snapshot
+
+Click **Take Snapshot** to manually save the current state. A prompt lets you enter a custom name — great for checkpoints like "Before refactor" or "Working config".
+
+### 4. Search & Filter
+
+Use the filter bar at the top of the panel to search snapshots by name. The clear button (**&times;**) resets the filter.
+
+### 5. Restore or Swap
+
+Each snapshot has two action buttons:
+
+| Button | Action |
+|--------|--------|
+| **Swap** | Replaces the current workflow in-place (same tab) |
+| **Restore** | Opens the snapshot as a new workflow |
+
+### 6. Delete & Clear
+
+- Click **&times;** on any snapshot to delete it individually
+- Click **Clear All Snapshots** in the footer to remove all snapshots for the current workflow (with confirmation dialog)
+
+## Settings
+
+All settings are available in **ComfyUI Settings > Snapshot Manager > Capture Settings**:
+
+| Setting | Type | Default | Description |
+|---------|------|---------|-------------|
+| **Auto-capture on edit** | Toggle | `On` | Automatically save snapshots when the workflow changes |
+| **Capture delay** | Slider | `3s` | Seconds to wait after the last edit before auto-capturing (1–30s) |
+| **Max snapshots per workflow** | Slider | `50` | Maximum number of snapshots kept per workflow (5–200). Oldest are pruned automatically |
+| **Capture on workflow load** | Toggle | `On` | Save an "Initial" snapshot when a workflow is first loaded |
+
+## Architecture
+
+<p align="center">
+  <img src="assets/architecture.png" alt="Architecture Diagram" width="100%"/>
+</p>
+
+**Data flow:**
+
+1. **Graph edits** trigger a `graphChanged` event
+2. A **debounce timer** prevents excessive writes
+3. The workflow is serialized and **hash-checked** against the last capture (per-workflow) to avoid duplicates
+4. New snapshots are written to **IndexedDB** (browser-local, persistent)
+5. The **sidebar panel** reads from IndexedDB and renders the snapshot list
+6. **Restore/Swap** loads graph data back into ComfyUI with a lock guard to prevent concurrent operations
+
+**Storage:** All data stays in your browser's IndexedDB — nothing is sent to any server. Snapshots persist across browser sessions and ComfyUI restarts.
+
+## FAQ
+
+**Where are snapshots stored?**
+In your browser's IndexedDB under the database `ComfySnapshotManager`. They persist across sessions but are browser-local (not synced between devices).
+
+**Will this slow down ComfyUI?**
+No. Snapshots are captured asynchronously after a debounce delay. The hash check prevents redundant writes.
+
+**What happens if I switch workflows?**
+Each workflow has its own snapshot history. Switching workflows cancels any pending captures and shows the correct snapshot list.
+
+**Can I use this with ComfyUI Manager?**
+Yes — install via ComfyUI Manager or clone the repo into `custom_nodes/`.
+
+## License
+
+[MIT](LICENSE)