diff --git a/README.md b/README.md
index 982d9fd..3bafb88 100644
--- a/README.md
+++ b/README.md
@@ -6,32 +6,70 @@ Auto-arrange your ComfyUI workflow nodes with a single click.
 
 ## Features
 
-- 4 layout algorithms: Layered (Sugiyama), Linear, Compact, Sort by Type
-- Group-aware — prettifies within groups, then arranges groups as blocks
-- 3 directions: Left-to-Right, Top-to-Bottom, Right-to-Left
-- Alignment & distribution tools (select 2+ nodes → right-click)
-- 10-deep undo stack
+- **4 layout algorithms**
+  - **Layered** — DAG columns with crossing minimization (Sugiyama). Best for standard pipelines.
+  - **Linear** — Single row in execution order. Good for simple chains.
+  - **Compact** — Rectangle packing for minimal canvas area.
+  - **Sort by Type** — Groups identical node types into columns.
+
+- **Group-aware** — Nodes inside groups are arranged within the group, then groups are positioned as blocks.
+
+- **3 directions** — Left-to-Right, Top-to-Bottom, Right-to-Left
+
+- **Alignment tools** — Select 2+ nodes, right-click → Align Left/Right/Top/Bottom, Center, Distribute evenly
+
+- **Configurable spacing** — Horizontal, vertical, and group padding sliders
+
+- **10-deep undo stack**
 
 ## Installation
 
-### ComfyUI Manager
+### ComfyUI Manager (Recommended)
 
-Search for **"Workflow Prettier"** and install.
+Search for **"Workflow Prettier"** in the ComfyUI Manager and install.
 
-### Manual
+### Manual (Git)
 
 ```bash
 cd ComfyUI/custom_nodes
 git clone https://github.com/Comfy-Org/comfyui-workflow-prettier.git
 ```
 
-Restart ComfyUI. No dependencies required.
+Restart ComfyUI. No pip dependencies required.
 
 ## Usage
 
-**Quick:** Right-click canvas → **Prettify Workflow** → pick a layout.
+### Quick Access
 
-**Full control:** Add the **Workflow Prettifier** node (`utils` category), configure settings, click **Prettify!**
+Right-click the canvas → **Prettify Workflow** → pick a layout. Uses sensible defaults.
+
+### Full Control
+
+1. Add the **Workflow Prettifier** node (search or find in `utils` category)
+2. Configure layout, direction, group handling, and spacing
+3. Click **Prettify!**
+4. Click **Undo** if you don't like the result
+
+### Alignment Tools
+
+1. Select 2+ nodes
+2. Right-click any selected node → **Align / Distribute**
+3. Choose from: Align Left/Right/Top/Bottom, Center H/V, Distribute H/V
+
+## Configuration
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| Layout | Layered | Layout algorithm |
+| Direction | Left to Right | Flow direction |
+| Group Handling | Auto | How to handle node groups |
+| Horizontal Spacing | 100 | Gap between columns |
+| Vertical Spacing | 100 | Gap between rows |
+| Group Padding | 100 | Padding inside groups |
+
+## Contributing
+
+Contributions welcome! Fork, branch, test with various workflows, and submit a PR.
 
 ## License