> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leapter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Blueprint Editor

> An overview of the Blueprint Editor — a single workspace where you read, build, run, and share the Blueprints in your project.

The Blueprint Editor is the main workspace in Leapter. Every project opens directly into the editor, and the editor shows the entire project at once: the type definitions, the project's inputs and outputs, every Blueprint in the project, and the dependencies between them.

The Blueprint Editor is a single page. There is no separate "diagram" page or "spec" page — you work in one place that combines a structured document view ([Specification view](/fundamentals/leapter-canvas/specification-view)) with the interactive diagrams embedded inline. When you want to focus on a single Blueprint's diagram, you maximize it in place — see [Diagram view](/fundamentals/leapter-canvas/diagram-view).

<img src="https://mintcdn.com/leapter/sFmIRxFaV3bB8R9b/images/editor-overview.png?fit=max&auto=format&n=sFmIRxFaV3bB8R9b&q=85&s=e3aa35ca5c2692c5650f7bc67a250c31" alt="The Blueprint Editor showing the top toolbar, Contents sidebar, document area with embedded diagram, and the tabbed right sidebar" width="1042" height="1122" data-path="images/editor-overview.png" />

## Editor layout

The editor is divided into four areas: a top toolbar, a Contents sidebar on the left, the document area in the center, and a tabbed sidebar on the right.

### Top toolbar

<img src="https://mintcdn.com/leapter/sFmIRxFaV3bB8R9b/images/editor-top-toolbar.png?fit=max&auto=format&n=sFmIRxFaV3bB8R9b&q=85&s=e0af962d3193f818f6e1d9d2a1ce9172" alt="Top toolbar with the live-execution play/pause button, a status pill, the maximized blueprint pill, trace controls, test status indicators, and the Share button" width="1949" height="45" data-path="images/editor-top-toolbar.png" />

The top toolbar runs across the top of the editor:

* **Toggle sidebar** — collapses or expands the main app sidebar (the narrow vertical strip with Projects, Profile, and API keys).
* **Live execution** — a **play / pause button** (with a status pill beside it) that controls [Live mode](/fundamentals/test-your-blueprint#live-mode). While it is running, your Blueprints re-execute automatically every time you change inputs or logic, so the Outputs footer in each section stays current. Pause it to stop auto-running; resume it to turn continuous execution back on.
* **Maximized blueprint pill** — when a Blueprint is maximized to its diagram, its name appears here. Click to switch which Blueprint is maximized; click the **X** to leave the maximized view.
* **Trace controls** — Jump to first / Previous / Step counter / Next / Jump to last, plus **Step into** and **Step out** for [Call nodes](/fundamentals/leapter-canvas/calling-other-blueprints), and **Exit trace**. These are active after you run a Blueprint and let you replay the execution step by step. See [Test your Blueprint](/fundamentals/test-your-blueprint#stepping-through-a-trace).
* **Share** — opens the [Share menu](/executing-blueprints/introduction#the-share-menu) with deployment options (Connect, n8n, Code, Embed, PNG, Export Source) and a **Link** for [public read-only links](/fundamentals/sharing).

### Contents sidebar (left)

The **Contents** sidebar shows everything in your project as a navigable table of contents:

* **Type Definitions** — reusable Value Types and Data Types defined at the project level. Double-click to open the [Type Definitions editor](/fundamentals/leapter-canvas/type-definitions).
* **Inputs and Outputs** — a shortcut to the project's external interface, which is the signature of the active [Execution Scope](#execution-scope-and-the-main-blueprint). See [Inputs and Outputs](/fundamentals/leapter-canvas/inputs-and-outputs).
* **Blueprints** — every Blueprint in the project, listed with its name. Each Blueprint shows its numbered sections (1, 1.1, 2, …) when expanded. Double-click a Blueprint or section to maximize it.
* **Dependencies** — at the bottom, a graph showing which Blueprints call which. Useful for navigating large projects and spotting circular dependencies.

Click any entry to scroll the document to that location. Double-click to maximize a Blueprint to its diagram.

#### Execution scope and the main Blueprint

A green spark icon (⚡) next to a Blueprint name marks it as the active **Execution Scope** — the entry point that runs when the project is invoked from outside. Its signature is the project's external interface (and what the **Inputs and Outputs** shortcut at the top of the sidebar points to). You can change which Blueprint is the active Execution Scope; the others remain in the project and can still be called via [Call nodes](/fundamentals/leapter-canvas/calling-other-blueprints).

#### Parameters and Quick Run

<img src="https://mintcdn.com/leapter/sFmIRxFaV3bB8R9b/images/contents-sidebar-expanded.png?fit=max&auto=format&n=sFmIRxFaV3bB8R9b&q=85&s=48db228035221d1c655b53d822aa313f" alt="The Contents sidebar with the Calculate Loan Application Scorecard blueprint expanded — the green spark marks the active Execution Scope, the parameter-count badge shows the number of inputs and outputs, and the expanded inputs and outputs are listed below with controls to set values" width="420" height="600" data-path="images/contents-sidebar-expanded.png" />

Each Blueprint in the Contents sidebar has a **# N** badge — the count of its inputs and outputs. Click it to expand the Blueprint's parameters in line:

* Each input shows its name, description, and a control to set a value (e.g. `not set` dropdown for an enum, a number field for a number)
* Each output shows its name, description, and the most recent value (after a run)

This is the **Quick Run** entry point: set values on the inputs, then run the Blueprint manually or leave **[Live mode](/fundamentals/test-your-blueprint#live-mode)** running to re-run automatically as you edit. See [Test your Blueprint](/fundamentals/test-your-blueprint).

### Document area (center)

The center area shows the project as a structured document. The top of the document shows the project's name and description, followed by Type Definitions, Inputs and Outputs, and then each Blueprint as a section with:

* A heading with the Blueprint name and description
* An interactive diagram showing the Blueprint's logic
* An Outputs footer (when [Live mode](/fundamentals/test-your-blueprint#live-mode) is running or after a manual run) showing the current output values

This is the **Specification view** — see [Specification view](/fundamentals/leapter-canvas/specification-view) for details on navigating and editing inside it.

To focus on a single Blueprint's diagram, double-click its entry in the Contents sidebar or click its maximize icon. The diagram fills the canvas and the rest of the document is hidden — see [Diagram view](/fundamentals/leapter-canvas/diagram-view).

### Right sidebar

<img src="https://mintcdn.com/leapter/sFmIRxFaV3bB8R9b/images/editor-right-sidebar.png?fit=max&auto=format&n=sFmIRxFaV3bB8R9b&q=85&s=33212884069c5944695b062600f99d6c" alt="The right sidebar tab strip with Tests, Agent, Prod Runs, and Comments" width="50" height="1053" data-path="images/editor-right-sidebar.png" />

The right sidebar is collapsed by default. Click any tab to open it:

* **Tests** — manage [test suites](/fundamentals/test-suites) for the active Blueprint. Create them manually or auto-generate with AI.
* **Agent** — open the **[Lab Agent](/fundamentals/change-your-blueprint/lab-agent)**, a conversational AI that builds and edits Blueprints, runs your tests, and proposes changes for you to approve.
* **Prod Runs** — execution logs from when your Blueprint runs in production via the [REST API](/executing-blueprints/connect-rest-api) or [MCP](/executing-blueprints/connect-mcp).
* **Comments** — leave comments on Blueprints, sections, or nodes for [team collaboration](/fundamentals/collaborating).

### Editor toolbar (right edge of a diagram)

<img src="https://mintcdn.com/leapter/sFmIRxFaV3bB8R9b/images/editor-canvas-toolbar.png?fit=max&auto=format&n=sFmIRxFaV3bB8R9b&q=85&s=0fc6bd28ea7987155070a7bf889a0c06" alt="Vertical canvas toolbar — sparkles for AI editing, a bot icon for the Lab Agent, undo, redo, settings, fit-to-view, plus, and minus" width="42" height="330" data-path="images/editor-canvas-toolbar.png" />

When a Blueprint is maximized, a small vertical toolbar appears on the right edge of the diagram canvas:

| Icon         | Action                                                                                                       |
| :----------- | :----------------------------------------------------------------------------------------------------------- |
| Sparkles     | [AI editing](/fundamentals/change-your-blueprint/ai-editing) — opens the AI prompt for the current selection |
| Bot          | Opens the [Lab Agent](/fundamentals/change-your-blueprint/lab-agent) to build or edit by chatting            |
| Undo / Redo  | Step through your edit history                                                                               |
| Settings     | Canvas display options                                                                                       |
| Fit to view  | Center and fit the diagram in the canvas                                                                     |
| Plus / Minus | Zoom in and out                                                                                              |

## What to do next

* **[Specification view](/fundamentals/leapter-canvas/specification-view)** — navigate and edit the project as a document
* **[Diagram view](/fundamentals/leapter-canvas/diagram-view)** — work inside a single Blueprint's diagram
* **[Inputs and Outputs](/fundamentals/leapter-canvas/inputs-and-outputs)** — define what data flows through your project
* **[Lab Agent](/fundamentals/change-your-blueprint/lab-agent)** — build and edit your Blueprints by chatting with AI
