flowboard

Architecture for platform engineers

Explain the system.
Follow the request.

Draw the services behind a request, connect the data path, and open a system to see its detail. People and agents work with the same portable Markdown, JSON and YAML model.

Start in your browser. No account or card required. Your existing draft stays yours.

Otters sketch architecture, float, and surf together on a teal river.

Go with the data flow

Every connection
has a story.

Follow a request from the customer to the database. Open the system, explore the services, and make the model your own.

Open this example

From customer to stored order

Customer sends a place-order request into Order system, where Public API stores it in Order database.

Open the system boundary and trace the place order and store order paths.

The image and readable source work without JavaScript.

Read the model source · Make your own example draft

One system, every altitude

Start at 10,000 feet.
Drill into the packets.

Show the whole platform for leadership, then open a cloud, cluster, or stream to work at service level. Breadcrumbs keep the audience oriented as the diagram gets deeper.

10,000 FT

System map

Clouds, regions, users, and the important data paths.

1,000 FT

Platform view

Clusters, registries, gateways, databases, and streams.

10 FT

Workload detail

Pods, topics, services, notes, and the exact direction of flow.

Built for architecture work

The canvas and the source stay together.

The diagram gives visual thinkers, text-first collaborators and AI agents a shared structure they can inspect and edit after the meeting.

01

Describe it, then see it

Give an agent your environment, code, or written instructions and have it produce an editable visual model.

02

Draw it, then ask it

Sketch the architecture visually and let an agent interpret the exact structure, flows, notes, and levels you created.

03

Round-trip every change

Move between the visual editor and portable Markdown, JSON, or YAML without flattening the diagram into an image.

04

Share on your terms

Keep diagrams private, share by email address, or publish a public link. Company plans add managed workspace sharing and policy controls.

A request has a story

Show what happens after the API responds.

An accepted order might still need to cross a topic and reach a worker. Put that asynchronous boundary in the diagram, label what moves through it and give the next engineer a path to follow.

Use notes to explain the assumptions that a line cannot: retries, duplicate delivery, ownership and what happens when a dependency is unavailable.

Explore the event-driven workflow
Orders API publishes to orders.v1, which passes the order to Fulfilment
One producer, one topic, one consumer. Start here and add the decisions that matter in your system.

A practical handoff

Give your agent something precise to work with.

Export the model you drew and ask an agent to explain the request path. Or start with a written description, create the model through MCP and inspect it in the editor.

Stable identifiers preserve the relationships when a label changes. Use a focused patch for small updates, validate the result and keep the source with the architecture discussion.

Bring your own compatible agent. Its credentials inherit your permissions; Flowboard does not include a proprietary AI model.

FLOWBOARD MARKDOWN

# Order processing

- Orders API {#api type=service}
- orders.v1 {#orders type=topic}
- Fulfilment {#worker type=service}

## Flows
- api -> orders {#publish label="order accepted"}
- orders -> worker {#consume label="fulfil order"}
Open the model behind this source

From a blank canvas to a useful model

Make one path clear today.

Start from a working example, rename a service and follow its connections. Local editing needs no account. Free Personal has no trial clock.