ArtsticH-ComfyUI_EasyKitHT_NodeAlignPro/README.md

ComfyUI_EasyKitHT_NodeAlign Pro 🎨

Completely reconstructed ComfyUI Node Alignment and Coloring Plugin, featuring brand-new UI icons and interface interaction logic. The layout of the alignment tool is more in line with the universal operational logic and experience in the design industry, and the position of the coloring tool is more reasonable, facilitating quick coloring operations.

🔥 [+] The major version update is here😁↓↓↓↓

The basic code and concept were basically completed as early as June-July this year, but due to my busy schedule recently, I have put it aside for a long time and have not updated it;

[+] I took time out to update it these two days. On the premise of retaining the UI and interaction habits of the previous version as much as possible, I redesigned the relevant UI, and basically reconstructed all the relevant logic (see the figure below👇).

✨ Core Features (Officially Launched)

💫Intelligent Alignment System	[+]💫New Coloring System	[+]💫User-Friendly Interaction Design	[+]💫New Color Picker (Original Design)
✅ 8 Basic Alignment Modes	[+]🖼️ One-Click Color Management Solution	🖱️ Floating Tool Panel	[+]✅ New Color Picking System Implemented with Native JS/CSS
📐 Dynamic Spacing Distribution Algorithm	[+]🔗 Real-Time Linked Display of Color Picking Effect	[+]🧩 New Custom Configuration	[+]🎨 Color Card Modes: Color/Gray Scale/Custom
👥 Collaborative Operation of Multiple Node Groups	[+]💾 Custom Color Card Collection and Restoration System	[+]💾 Layout Memory and Restoration System	[+]👏 Color Cards: Random/Collect/Remove/Manual Addition

✅ New Version Effect Demo🖼️

⚠️ Note: Regarding multiple alignment modes, you can try Alt key + Alignment Button to experience the new alignment methods in the new easter egg feature.

(Note: The alignment-related functions of the new Node2.0 Beta version are not yet stable, and there are cumulative offset issues due to various conversion errors. Reproduction: You can repeatedly enable/disable the native Node2.0 Beta switch in ComfyUI, and you will find that nodes accumulate errors, and their sizes and coordinates will continue to shift. Therefore, adaptation is temporarily not provided (although Node2.0 adaptation has been completed, the logic for adapting to Node2.0 is temporarily removed and will be updated back when it is more stable))

⚠️ [+] Note: The three major modules - 💫Brand New Coloring System, 💫User-Friendly Interaction Design, and 💫New Color Picker (Original Design) - have all been refactored to varying degrees, while retaining the basic operation logic of the v1.0.4_rc version as much as possible. Due to being busy in daily life and developing as a hobbyist (not a professional programmer), there may inevitably be many bugs in this hasty update. Please help test it, and feel free to submit Issue feedback. Thank you for your support and understanding!

❌ Old Version Interface Comparison

---

🛠️ Installation Guide

Manual Installation

1. Download the Latest Release
2. Unzip it to the ComfyUI/custom_nodes/ directory
3. Restart the ComfyUI service

Git Installation

git clone https://github.com/ArtsticH/ComfyUI_EasyKitHT_NodeAlignPro.git custom_nodes/ComfyUI_EasyKitHT_NodeAlignPro

Git update (Manual navigation to the ComfyUI_EasyKitHT_NodeAlignPro directory is required first)

git fetch --all

🚀 Quick Start

Example Workflow Configuration (for reference only)

{
    "nodes": [
        {
            "type": "ComfyUI_EasyKitHT_NodeAlignPro/AlignGroup",
            "params": {
                "alignment_mode": "vertical_center",
                "spacing": 50,
                "color_scheme": "cyan"
            }
        }
    ]
}

📌 Function Details

• Node Alignment
  Left/Right/Top/Bottom Alignment, Horizontal/Vertical Centering, Smart Spacing Distribution

• Node Coloring
  7 Preset Color Schemes: orange, yellow, green, cyan, blue, purple, Custom Color Picker, One-click Reset

🤝 Contribution Guide

• Welcome to participate in the improvement in the following ways:
  Submit Usage Feedback、New Issue、Improve Code Logic、Fork & PR、Complete Multilingual Documents、Share Creative Workflows

📜 License Agreement

• This project uses the MIT License. The development idea is based on the secondary development ofComfyUI-NodeAligner and ComfyUI-Align.
• It mainly refactored the code and rewrote the UI, thus developing the lightweightComfyUI_EasyKitHT_NodeAlignPronamedComfyUI plugin.
• The core functions are: Node AlignmentandNode Coloring.

👨💻 This is a project developed by a designer in his spare time. Welcome to feedback on usage issues. ⚠️ There may be exceptions in untested scenarios. Please report them through Issues.