diff --git a/README.md b/README.md
index 7b12ce7..4b4fce8 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,6 @@
 <div align="center">
     <img src="imgs/extralinks_logo.png">
-</div>
-
-
+</div><br>
 
 A one-click collection of alternate connection styles for ComfyUI.
 
@@ -16,3 +14,124 @@ A one-click collection of alternate connection styles for ComfyUI.
 <div align="center">
     <img width=800 src="imgs/extralinks_example.gif">
 </div>
+
+------------------------------------------------------------------
+
+## Requirements
+
+**ComfyUI frontend**: ≥ **1.27.1** (new link renderer API)
+
+> On older ComfyUI versions, use ExtraLinks v0.0.2 (see Compatibility).
+
+------------------------------------------------------------------
+
+## Installation
+
+### Git Clone
+
+```powershell
+cd ComfyUI\custom_nodes
+git clone https://github.com/edoardocarmignani/extralinks.git
+```
+
+Restart ComfyUI (or just reload the browser tab if ComfyUI is already running).
+
+### ComfyUI Manager
+
+Go to **Custom Nodes Manager** and search for **Extra Links**.
+
+------------------------------------------------------------------
+
+## Usage
+
+Open **Settings** → **Extra Links** and configure:
+
+- **Enable**: toggle on/off
+- **Shape**: `Curved` | `Rounded`
+- **Radius**: corner smoothing
+- **Offset**: horizontal separation for multi-outputs
+- **Curvature**: strength of turn-in/out
+
+Changes apply immediately to the canvas.
+
+------------------------------------------------------------------
+
+## Compatibility
+
+| ExtraLinks version | ComfyUI frontend | Notes |
+|--------------------|------------------|-------|
+| **1.0.0+**         | **≥ 1.27.1**     | Uses new `drawLinkPath` API |
+| 0.0.2              | < 1.27.1         | Legacy `renderLink` patch |
+
+> Staying on an older ComfyUI? Keep using **v0.0.2** (see legacy tag/releases).  
+
+------------------------------------------------------------------
+
+## Troubleshooting
+
+- **Only the center dot appears**  
+Likely start/end were read as arrays. Ensure you’re on **v1.0.0+**; we read `{x,y}` points.
+- **No lines drawn**  
+Check DevTools Console for warnings from ExtraLinks; verify ComfyUI is **≥ 1.27.1**.
+- **After toggling Enable nothing changes**  
+Try reloading the page; ensure there’s no other extension overriding link rendering.
+
+If issues persist, please open an issue with:
+
+- ComfyUI frontend commit/date
+- Browser + OS
+- A screenshot / brief recording
+- Console logs (copy/paste)
+
+👉 [Open an issue](https://github.com/edoardocarmignani/extralinks/issues)
+
+------------------------------------------------------------------
+
+## Versioning & Releases
+
+- **1.0.0** — Migration to new ComfyUI link renderer (**breaking**: drops < 1.27.1).
+
+> See `CHANGELOG.md` for details.
+
+Tags:
+
+- `v1.x.y` → current series.
+- `v0.0.2` → legacy (for older ComfyUI).
+
+------------------------------------------------------------------
+
+## Development
+
+- Main code lives in `extralinks/web/ExtraLinks.js`
+- Settings/registration live in `extralinks/web/extralinks_register.js`
+- Python exposes `WEB_DIRECTORY` via `extralinks/__init__.py`
+
+Typical flow:
+
+```bash
+# edit JS files
+# reload ComfyUI browser tab
+# watch console for "[Extra Links]" logs
+```
+
+Optional Runtime guard:
+
+```javascript
+const ok = app?.canvas?.linkRenderer?.pathRenderer?.drawLinkPath;
+if (!ok) {
+  console.warn("[ExtraLinks] Requires ComfyUI frontend >= 1.27.1");
+}
+```
+
+------------------------------------------------------------------
+
+## License
+
+MIT (see [LICENSE](LICENSE))
+
+------------------------------------------------------------------
+
+## Credits
+
+- Built by [@edoardocarmignani](https://github.com/edoardocarmignani)
+- Thanks to the ComfyUI community for the incredible work