ForgeDraw logo

ForgeDraw User Guide

A Sketchy Diagram Drawing Tool

Quick Start

  1. Go to forgedraw.dreamforgeworld.com and click Start Drawing, or open the editor directly at forgedraw.dreamforgeworld.com/app.
  2. 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.

Canvas Navigation

Selection and Movement

Drawing Tools

Pick a tool from the left sidebar, then click-drag on the canvas to draw.

Styling

Arrows

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:

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

🚧 Import PNG Experimental

This feature is under active development. You can import an existing image and convert it into editable shapes — results may vary.

Copy / Paste

Grouping

Right-Click Menu

Command Palette

Minimap

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

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

Good to know

If it does not connect

Tools the server offers

ToolWhat it does
connection_checkConfirms the server is running and whether a canvas is open.
open_canvasOpens ForgeDraw in your browser and waits for it to connect.
get_diagramLists what is on the canvas or in a file, with ids, labels and positions.
add_itemsAdds shapes, icons, text and arrows, connected in one step.
update_itemsMoves, resizes, restyles or relabels items.
delete_itemsDeletes items.
arrange_itemsLayout, Tidy, Equalize or Fit Text.
group_itemsGroups or ungroups items.
new_diagramClears the canvas, or creates an empty diagram file.
load_into_canvasPuts a diagram file on the canvas, replacing or adding to what is there.
export_diagramReturns a PNG of the canvas, or writes SVG or JSON.
canvas_commandUndo, redo, zoom to fit, reset view, select, theme, grid.
list_iconsFinds Lucide icon names.

App Controls