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

# 2.x

> FlowDrop 2.x release highlights

A glanceable summary of the 2.x line. For the full, detailed notes — every
fixed bug, internal change, and migration step — see the
[complete changelog on GitHub](https://github.com/flowdrop-io/flowdrop/blob/main/libs/flowdrop/CHANGELOG.md).

<Note>
  Upgrading from 1.x? The
  [2.0 migration guide](https://github.com/flowdrop-io/flowdrop/blob/main/libs/flowdrop/MIGRATION-2.0.md)
  walks through every breaking change step by step.
</Note>

<Update label="2.0.0-beta.3" description="2026-06-12" tags={["Beta", "Breaking"]}>
  Finishes the navbar/theme defaults pass and adds the Drafter blueprint theme.

  <Frame>
    <img src="https://mintcdn.com/flowdrop/A476CS6LBmOR9RPd/images/screenshots/drafter.webp?fit=max&auto=format&n=A476CS6LBmOR9RPd&q=85&s=d524f28bd9ae127ad7a2af2aef4de867" alt="New theme called Drafter showing FLowDrop editor." width="3840" height="1748" data-path="images/screenshots/drafter.webp" />
  </Frame>

  * **Drafter blueprint theme** — a third built-in editor theme (light + dark): a mint canvas, a subtle emerald line grid, and translucent green-tinted nodes. Ships with per-theme canvas grids (`dots` | `lines` | `cross`) via the new `FlowDropGridVariant`.
  * **Navbar & theme defaults** — the navbar is now opt-in on every mount path (`showNavbar` defaults to `false`), `light` is the default theme for embeds with no saved choice, and the header shows the FlowDrop wordmark.
  * **Keyboard navigation & focus** — each node is a single tab stop again (the config gear left the tab order, deferring to xyflow's node focus), backed by one centralized focus ring across the whole library.
  * **Full editor renders built-in editors out of the box** — markdown / code / template config fields no longer fall back to a textarea after the beta.2 light-entry split; add `features: { builtinEditors: false }` to opt out.

  [Full notes →](https://github.com/flowdrop-io/flowdrop/blob/main/libs/flowdrop/CHANGELOG.md#200-beta3---2026-06-12)
</Update>

<Update label="2.0.0-beta.2" description="2026-06-09" tags={["Beta", "Breaking"]}>
  Tightens the 2.0 package boundaries and finishes the auth work.

  * **Light entries stay light** — `core`, `form`, and `editor` no longer statically pull heavy deps (CodeMirror, `@xyflow/svelte`, `marked`, DOMPurify), enforced by a new CI bundle guard (`pnpm run check:bundle`).
  * **`AuthProvider` reaches every runtime surface** — playground, chat, interrupt, settings, editor, and pipeline requests all route through the configured provider, including standalone mounts.
  * 500-node editor render benchmark added to the e2e suite.

  [Full notes →](https://github.com/flowdrop-io/flowdrop/blob/main/libs/flowdrop/CHANGELOG.md#200-beta2---2026-06-09)
</Update>

<Update label="2.0.0-beta.1" description="2026-06-07" tags={["Beta", "Breaking"]}>
  The headline 2.0 release: state, API, and registries are now instance-scoped.

  * **Multiple FlowDrop instances per page** — every mount creates an isolated `FlowDropInstance`; module-level singleton stores are gone (`app.instance.workflow`, `fd.api`, `fd.nodes`, …).
  * **`mode` prop** (`'edit' | 'readonly' | 'locked'`) replaces `readOnly` + `lockWorkflow`.
  * **Auth via `AuthProvider`** — `EndpointConfig.auth` is removed in favour of `StaticAuthProvider` / `NoAuthProvider` / `CallbackAuthProvider`.
  * **Slim main entry** — `@flowdrop/flowdrop` exposes only the bootstrap surface; everything else moves to its owning sub-module.
  * **Workflow `metadata` is required**, and `metadata.version` is renamed to `metadata.schemaVersion` (1.x JSON heals automatically on load).

  [Full notes →](https://github.com/flowdrop-io/flowdrop/blob/main/libs/flowdrop/CHANGELOG.md#200-beta1---2026-06-07) · [Migration guide →](https://github.com/flowdrop-io/flowdrop/blob/main/libs/flowdrop/MIGRATION-2.0.md)
</Update>