mirror of https://github.com/Comfy-Org/ComfyUI_frontend.git synced 2026-07-02 04:27:25 +00:00

Files

Alexander Brown b4ae6344d7 Brand local node IDs (#13085 )

## Summary

Adds a branded local `NodeId` helper and starts separating local node
identity from serialized workflow IDs.

## Changes

- **What**: Adds central `NodeId` parsing/branding helpers, migrates
nearby widget identity types, keeps queue results at the serialized
boundary, and removes misleading workflow `NodeId` usage from execution
error maps.

## Review Focus

Check that the first migration slice keeps serialized/API IDs as raw
`number | string` while local UI/store IDs use the branded string type.

## Caveat

`SUBGRAPH_INPUT_ID` and `SUBGRAPH_OUTPUT_ID` are now branded local
`NodeId` string values internally instead of numeric sentinels.
Reviewers should double-check extension compatibility for callers that
import `Constants` and compare those values numerically.

## Screenshots (if applicable)

N/A

---------

Co-authored-by: GitHub Action <action@github.com>
Co-authored-by: AustinMroz <austin@comfy.org>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-26 22:54:04 +00:00

core.md

feat: remove deprecated group nodes, auto-convert to subgraphs on load (#12931 )

2026-06-18 21:16:24 +00:00

development.md

Chore: Oxfmt formatting pass (#8341 )

2026-01-27 17:59:19 -08:00

node-id-migration.md

Brand local node IDs (#13085 )

2026-06-26 22:54:04 +00:00

README.md

Brand local node IDs (#13085 )

2026-06-26 22:54:04 +00:00

README.md

ComfyUI Extensions Documentation

Overview

Extensions are the primary way to add functionality to ComfyUI. They can be custom nodes, custom nodes that render widgets (UIs made with javascript), ComfyUI shell UI enhancements, and more. This documentation covers everything you need to know about understanding, using, and developing extensions.

Documentation Structure

Development Guide - How to develop extensions, including:
- Extension architecture and terminology
- How extensions load (backend vs frontend)
- Why extensions don't work in dev server
- Development workarounds and best practices
Core Extensions Reference - Detailed reference for core extensions:
- Complete list of all core extensions
- Extension architecture principles
- Hook execution sequence
- Best practices for extension development
Node ID Migration Notes - Compatibility guidance for branded node IDs and subgraph boundary sentinel values

README.md

ComfyUI Extensions Documentation

Overview

Documentation Structure

Quick Links

Key Concepts

Common Tasks

External Resources

Need Help?