Files

T

History

Dustin f6b8ccb87a Simplify sync script to always copy files (remove symlink mode)

ComfyUI's web server doesn't follow symlinks for security reasons, causing 404
errors when trying to load JavaScript files. Simplified sync_web_files.py to
always copy files instead of attempting symlinks.

Changes:
- Removed dev/prod mode detection and symlink creation logic
- Always copy files from source to web/ directory
- Hash-based caching still prevents unnecessary re-syncs
- Auto-sync on ComfyUI startup keeps files current
- Updated README.md to reflect copy-only behavior

Workflow: After editing source files, run `python scripts/sync_web_files.py --force`
then restart ComfyUI to see changes.

Tested: Manual copies work, UI loads correctly, cache prevents redundant syncs

2025-11-02 13:50:08 -05:00

README.md

Simplify sync script to always copy files (remove symlink mode)

2025-11-02 13:50:08 -05:00

README.md

DazzleNodes Web Resources (Auto-Generated)

⚠️ DO NOT EDIT FILES IN THIS DIRECTORY

This directory is automatically generated when ComfyUI loads DazzleNodes.

How It Works

When ComfyUI imports DazzleNodes (__init__.py), it runs scripts/sync_web_files.py to automatically sync JavaScript files from their source locations to this directory.

Source Locations (Priority Order)

web_src/core/ - Shared JavaScript libraries (highest priority)
core_nodes/*/web/ - Built-in DazzleNodes nodes
nodes/*/web/ - Git submodule nodes (lowest priority)

Directory Structure

web/
├── README.md           # This file (committed to git)
├── .sync_hash          # Cache file (gitignored)
├── core/               # Shared libraries (gitignored)
│   └── *.js
└── node-name/          # Per-node JavaScript (gitignored)
    └── *.js

File Sync Behavior

The sync script always copies files (ComfyUI's web server doesn't follow symlinks):

Files in web/ are copies of sources
Hash-based caching prevents unnecessary re-syncs
Auto-sync runs on ComfyUI startup
Manual sync with python scripts/sync_web_files.py --force after editing source files

Caching

The sync script uses MD5 hashing of all source files to detect changes:

If sources unchanged: Skips sync (fast startup)
If sources changed: Re-syncs all files
Force sync: python scripts/sync_web_files.py --force

Manual Sync

You can manually trigger a sync after editing source files:

cd C:\code\DazzleNodes\local

# Use cache (only sync if files changed)
python scripts/sync_web_files.py

# Force sync (ignore cache)
python scripts/sync_web_files.py --force

# Verbose output
python scripts/sync_web_files.py --verbose

# Quiet mode (for scripts)
python scripts/sync_web_files.py --quiet

Troubleshooting

JavaScript Not Loading

Check if auto-sync ran: Look for [DazzleNodes] messages in ComfyUI console
Force sync: python scripts/sync_web_files.py --force --verbose
Check source files exist:
- nodes/smart-resolution-calc/web/ (should have .js files)
- web_src/core/ (if using shared libraries)

Changes Not Visible After Editing Source Files

Force sync: python scripts/sync_web_files.py --force
Restart ComfyUI completely
Check browser console for JavaScript errors
Clear browser cache (Ctrl+Shift+R)

Architecture Details

For complete architecture documentation, see:

private/claude/2025-11-02__09-15-35__auto-sync-web-architecture-with-core-nodes.md

Questions?

Check the main DazzleNodes README or scripts/README.md for more information