Quick Start
- Go to forgedraw.dreamforgeworld.com and click Start Drawing, or open the editor directly at forgedraw.dreamforgeworld.com/app.
- Start drawing! Pick a shape tool from the left sidebar and click-drag on the canvas.
Saving Your Work
Your diagrams live in your browser session only — nothing is stored on a server.
- Save: click “Save” in the top bar to download your diagram as a JSON file. ForgeDraw shows a confirmation toast, and your browser saves it in your normal downloads location. Re-open it later with “Load”.
- Autosave: your diagram is automatically saved to browser storage every few seconds. If you accidentally close the tab, a recovery prompt will appear next time you open ForgeDraw.
- Export as image: use “Ex PNG”, “Copy PNG”, or “SVG” in the top bar to export your diagram as a picture.
- Your chosen theme (light/dark) is remembered between visits.
Canvas Navigation
- Pan: hold the middle mouse button (scroll wheel) and drag to move around the canvas.
- Zoom: scroll the mouse wheel to zoom in and out.
- Fit: click “Fit” in the top bar to zoom so the entire diagram fits on screen.
- Reset: click “Reset” to return to the default zoom and position.
Selection and Movement
- Select: left-click a shape or text to select it.
- Move: drag the selected item to reposition it.
- Multi-select: hold
Shiftand click to add/remove items, or holdShiftand drag on empty canvas to draw a selection box. - Sweep select: click the “ptr/swp” toggle under Select in the sidebar to switch to Sweep mode — drag across items to select them without releasing the mouse.
- Group move: when multiple items are selected, dragging one moves them all.
- Nudge: use arrow keys to move selected items in small steps (hold
Shiftfor bigger steps). - Snap guides: when you drag shapes near each other, alignment guides appear automatically.
- Grid snap: toggle the “Grid” button in the top bar to snap items to a grid. You can adjust the grid size next to the button.
- Tidy: select 2 or more items and click “Tidy” to arrange them in a neat row or grid.
- Fit Text: select a shape that has text inside it and click “Fit Text” to resize the shape to match the text.
- Equalize: select 2 or more shapes and click “Equalize” to make them all the same size.
- Delete: press
DeleteorBackspaceto remove selected items. - Select All: press
Ctrl+A(Cmd+Aon Mac) to select every shape, text, and arrow.
Drawing Tools
Pick a tool from the left sidebar, then click-drag on the canvas to draw.
- Rectangle, Ellipse, Diamond, Triangle, Hexagon: click-drag to draw the shape.
- Pen: click-drag to draw freehand sketches.
- Arrow: click-drag from one shape to another to connect them. Small dot markers show where connectors will attach.
- Text: click to place a text box, then type. Press
Enterto save (Shift+Enterfor a new line,Escto cancel). Double-click existing text to edit it. Text placed inside a shape automatically wraps to fit the shape width. You can also drag existing text onto a shape to attach and auto-fit it. - Eraser: click any shape, arrow, or text to delete it. Use the “clk/swp” toggle under Eraser in the sidebar for sweep erase — drag across items to erase everything the cursor touches.
Styling
- Stroke color: click the colored circle in the styling row to pick a stroke color. This sets the color for new shapes and also applies instantly to any selected shapes or arrows.
- Stroke width: click a thickness button in the styling row to change line weight (1, 2, 3, 5, or 8). Applies to new shapes and to any selected shapes or arrows.
- Stroke style: click the solid/dashed/dotted buttons in the styling row to change line style. Use dashed lines to indicate planned or optional elements. Applies to new shapes and to any selected shapes or arrows.
- Fill color: click the square swatch in the styling row to pick a fill color. Choose from pastels, saturated colors, or “no fill” (transparent). Fills render at 35% opacity to maintain the sketchy aesthetic. Applies to new shapes and to any selected shapes.
- Edit existing styles: select a shape or arrow, and the stroke/fill controls appear in the styling row showing the item’s current colors. Pick a new color, width, or style to update the selected items. Fully undoable.
- Font: choose from five handwriting fonts — Caveat (default), Patrick Hand, Kalam, Comic Neue, or Architects Daughter — using the dropdown in the styling row.
- Font size: click S / M / L / XL in the styling row to set font size. Applies to new text and any selected text.
- Text color: click the colored circle in the styling row to pick a text color. Applies to new text and any selected text.
- Bold / Italic: select text and press
Ctrl+BorCtrl+I(or use the B / I buttons in the styling row). - Text alignment: select text and click “Align” in the styling row to cycle between left, center, and right.
Arrows
- Straight vs. Elbow: when the Arrow tool is active, click the “str/elb” toggle beneath it in the sidebar to switch between straight-line and orthogonal (right-angle) routing. You can also toggle an existing arrow by selecting it and clicking the “Straight/Elbow” button in the styling row.
- Edit endpoints: select an arrow, then drag its endpoint handles to reattach to different shapes.
- Labels: select an arrow and click its label area to add or edit text on the arrow. Once a label has text it stays visible when the arrow is not selected, and it appears in PNG and SVG exports.
- Move: select an arrow and drag to reposition it.
Icons
ForgeDraw includes the full Lucide icon library (~1,900 icons) you can drop onto the canvas to build system architecture diagrams, ERDs, and flowcharts.
Opening the icon panel
Click the panel icon in the top-right header (next to the theme toggle) to show or hide the right-side Icons panel. The panel’s open/closed state is remembered across reloads.
The panel auto-hides on narrow screens (below about 834 pixels wide).
Pinned icons
When the panel opens, you see a curated set of ~30 icons that work well in diagrams: server, database, cloud, user, lock, mail, globe, and more. These are always visible under the Pinned header.
Searching all icons
Type in the search box to filter across the entire Lucide library — try “server”, “lock”, “wifi”, “file”, “cloud”. The grid switches to a Results (N) view. Clear the search to return to pinned icons.
Dragging icons onto the canvas
Drag any tile from the panel onto the canvas. The icon appears at the drop point as a 48×48 shape, already selected.
Once on the canvas, an icon behaves like any other shape:
- Move, resize, rotate with the selection handles (minimum size 16×16).
- Recolor the outline via the stroke controls.
- Connect it with arrows — arrow endpoints snap to icon edges.
- Add a label by double-clicking inside the icon. The label sits under the icon as a caption and moves with it.
- Group with other shapes, copy/paste, undo/redo — all work the same.
Sketchy mode
Icons render with clean vector strokes by default — consistent with Lucide’s look.
Select an icon and look for the Sketchy button in the second topbar row. Click it to re-render the icon hand-drawn (matching the sketchy style of ForgeDraw’s shapes). Click again to go back to clean. Each icon has its own sketchy state, so you can mix both modes freely.
Undo / Redo
- Click “Undo” or “Redo” in the top bar, or press
Ctrl+Z/Ctrl+Y(Cmd+Z/Cmd+Yon Mac).
🚧 Import PNG Experimental
This feature is under active development. You can import an existing image and convert it into editable shapes — results may vary.
- Click “Import” in the top bar and choose a PNG file.
- Local detection works instantly, no setup needed — best with simple black-and-white images.
- AI detection can recognize shapes in more complex or colored images. It requires a free API key from OpenRouter — the import dialog walks you through the setup.
- After detection, review the results and toggle shapes on/off before adding them to your canvas.
Copy / Paste
- Copy: select items and press
Ctrl+C(Cmd+Con Mac) to copy them to the clipboard. - Paste: press
Ctrl+V(Cmd+Von Mac) to paste. Pasted items appear offset by 20px and become the new selection. You can also right-click on the canvas and choose Paste to place items at the click location. - Duplicate: press
Ctrl+D(Cmd+Don Mac) to duplicate selected items in one step. - Arrows connected to copied shapes stay connected. Arrows referencing shapes not in the clipboard become free-floating.
- Grouped items retain their group relationships when pasted.
Grouping
- Select 2 or more items and press
Ctrl+Gto group them. Selecting one item in a group selects all of them. - Press
Ctrl+Shift+Gto ungroup.
Right-Click Menu
- Right-click any shape, icon, arrow, or text to open a context menu. Right-clicking a target that isn't already selected auto-selects just that item (mirrors Figma / Finder). Right-clicking an item that's already part of a multi-selection keeps the whole selection intact.
- The top of the menu has quick Select mode and Arrow mode toggles — a ✓ marks the currently active tool. Clicking either switches the tool and closes the menu, so you can immediately draw an arrow between shapes or return to select mode without traversing to the sidebar.
- The menu includes Delete, Duplicate, Copy, Paste, Group, Ungroup, and inline color swatches for changing stroke and fill colors without going to the top bar.
- Stroke row appears when the selection contains any shape, icon, or arrow.
- Fill row appears only when the selection contains a non-icon shape (icons and arrows are outline-only).
- Right-click on empty canvas for Paste and Select All.
- The menu auto-clamps to stay on screen when you right-click near a viewport edge.
Command Palette
- Press
Ctrl+K(Cmd+Kon Mac) to open the command palette. - Type to search for any tool or action, then press Enter to run it.
Minimap
- A minimap in the bottom-right corner shows an overview of your diagram.
- Click on the minimap to jump to that area of the canvas.
- Drag the minimap by its top edge to reposition it anywhere on screen.
- Click the × to hide it; click “Map” to show it again.
Connect an AI Agent (Claude, Codex)
ForgeDraw comes with an MCP server, so Claude Code, Claude Desktop and Codex can draw and edit diagrams for you. Ask for “an architecture diagram of this repo” and it appears on your canvas. Every change the agent makes goes into your normal undo history.
What an agent can do
- Read the canvas: every shape with its label, position and colours, every arrow and what it connects, free text, and what you have selected.
- Draw: rectangles, ellipses, diamonds, triangles, hexagons, pen strokes, any of the ~1,900 Lucide icons, text, and labelled arrows. A whole connected diagram can go in with one request.
- Edit: move, resize, recolour, relabel, change line style (solid, dashed, dotted), font, size, bold, italic and alignment; reconnect arrows or switch them between straight and elbow.
- Arrange: lay a flowchart or architecture diagram out by following its arrows, or use the same Tidy, Equalize and Fit Text as the toolbar buttons.
- Group, ungroup and delete.
- Check its work: look at the canvas as a PNG, export SVG, or save the diagram as a JSON file you can Load later.
- Run canvas commands: undo, redo, zoom to fit, reset the view, select items to show you what it means, switch theme, turn the grid on or off.
- Work on diagram files (
.json) without the canvas open.
An agent cannot use Import PNG (it can look at an image itself and draw what it sees), your clipboard, or the help, minimap and sidebar.
How it works
The MCP server runs on your computer. It serves its own copy of ForgeDraw at http://127.0.0.1:47821/app, which only your computer can reach, and that page connects back to the server. When it does, the footer shows Agent connected.
The public site at forgedraw.dreamforgeworld.com cannot connect to an agent: browsers do not let a public web page talk to programs on your computer. Nothing is sent to a server and there is no account.
The copy at 127.0.0.1 keeps its own autosave, separate from the public site. To move a diagram between them, Save it on one and Load it on the other.
Set it up once
You need Node.js 20 or newer and the ForgeDraw source folder. In that folder, run:
npm install
npm run setup:mcp
This builds the app and the server file mcp/dist/forgedraw-mcp.mjs. In the commands below, replace /path/to/forgedraw with the full path to your ForgeDraw folder. On Windows, forward slashes work, for example H:/forgedraw.
Claude Code
claude mcp add --scope user forgedraw -- node /path/to/forgedraw/mcp/dist/forgedraw-mcp.mjs
Run claude mcp list to check it, or /mcp inside a session.
Codex
codex mcp add forgedraw -- node /path/to/forgedraw/mcp/dist/forgedraw-mcp.mjs
Or add it to ~/.codex/config.toml yourself:
[mcp_servers.forgedraw]
command = "node"
args = ["/path/to/forgedraw/mcp/dist/forgedraw-mcp.mjs"]
Claude Desktop
Open Settings, then Developer, then Edit Config, and add this to claude_desktop_config.json. Restart Claude Desktop afterwards.
{
"mcpServers": {
"forgedraw": {
"command": "node",
"args": ["/path/to/forgedraw/mcp/dist/forgedraw-mcp.mjs"]
}
}
}
Claude on the web (claude.ai) cannot reach a server on your computer, so it cannot use ForgeDraw’s MCP server.
Test the connection
Paste this into your agent:
Use the forgedraw connection_check tool and nothing else, then tell me in one sentence whether ForgeDraw is connected and whether a canvas is open.
Open the canvas
Ask the agent to open ForgeDraw. It opens http://127.0.0.1:47821/app in your browser and waits for the page to connect. You can also open that address yourself while the agent is running.
Things to ask for
- “Draw the architecture of this repo in ForgeDraw.”
- “Turn this SQL schema into an ERD.”
- “Make the selected boxes green and line them up.”
- “Save the canvas to docs/architecture.json and export an SVG next to it.”
Good to know
- Each agent request is one undo step. Press
Ctrl+Zto take it back. - After each change, the agent’s new items are selected and a message at the bottom of the screen says what changed.
- If you draw while the agent is working, your drawing is kept. The agent redoes its step on top of it.
- Several agents can share one canvas, for example Claude Code and Codex at the same time.
- A shape the agent deletes takes its label and its arrows with it. You can still undo that.
- Diagram files the agent writes are ordinary ForgeDraw files. It only writes
.json,.svgand.pngfiles, and it will not replace an existing file unless you ask it to.
If it does not connect
- Footer says “Agent: waiting”: the page is open but the server is not running. The server starts with your agent session, so start one, and the page reconnects by itself within a few seconds.
- The page says the app has not been built: run
npm run buildin the ForgeDraw folder and reload. - Port 47821 is taken by another program: set
FORGEDRAW_PORTto a free port in the server’s settings, for exampleclaude mcp add --scope user -e FORGEDRAW_PORT=47900 forgedraw -- node /path/to/forgedraw/mcp/dist/forgedraw-mcp.mjs, then openhttp://127.0.0.1:47900/app.
Tools the server offers
| Tool | What it does |
|---|---|
connection_check | Confirms the server is running and whether a canvas is open. |
open_canvas | Opens ForgeDraw in your browser and waits for it to connect. |
get_diagram | Lists what is on the canvas or in a file, with ids, labels and positions. |
add_items | Adds shapes, icons, text and arrows, connected in one step. |
update_items | Moves, resizes, restyles or relabels items. |
delete_items | Deletes items. |
arrange_items | Layout, Tidy, Equalize or Fit Text. |
group_items | Groups or ungroups items. |
new_diagram | Clears the canvas, or creates an empty diagram file. |
load_into_canvas | Puts a diagram file on the canvas, replacing or adding to what is there. |
export_diagram | Returns a PNG of the canvas, or writes SVG or JSON. |
canvas_command | Undo, redo, zoom to fit, reset view, select, theme, grid. |
list_icons | Finds Lucide icon names. |
App Controls
- Logo: click the ForgeDraw logo to return to the production home page.
- Theme: click the Light/Dark toggle in the header to switch themes.
- Help: click the “?” button in the header for quick tips. Drag the title bar to move it, drag the bottom-right corner to resize, click ⧉ to pop it out as a floating panel, or press
Escto close. - All shapes render with a sketchy, hand-drawn style.