Blueprints
Documentation that opens on the diagram
A blueprint is a document that opens on a diagram. Draw the system, write the detail into the shapes, publish one link. Change it later and every reader has the new version.
Free plan and up
Drawing the canvas, writing the detail behind a shape, and publishing the blueprint to one URL.
Why Blueprints
Diagram-first documents that never drift.
The diagram is the page
The canvas is the front page. A reader sees the whole system before reading a word of it, then opens the box they came for.
Detail lives in the shape
Click a shape and its stratum opens: markdown, tables, code, files, links. You never leave the diagram to read the detail.
One link, no export step
Publish once. Share the URL, or paste the embed into Confluence, SharePoint, a README, your intranet. All of them show the current version.
Features
More about Blueprints
Public, private, unlisted or draft
Four states on every blueprint. On Team, put a password on the ones you send to a client.
Versioned, with visual diffs
Every publish keeps the one before it. The history shows what changed at each step.
Files and folders alongside
Attach the runbook, the Terraform, the spreadsheet. They travel with the blueprint.
Discussion on the document
Comments land on the blueprint, next to whatever prompted them.
Examples
Blueprints people have published
Real documents on Blueprintr, open to read.
Enterprise Azure environment
An Azure hub-and-spoke design connected to an on-premises network through ExpressRoute. Includes identity services, application workloads, addressing and firewall policy.
Rivulet webhook relay
Rivulet's architecture, delivery state machine and database schema, with installation instructions, operating notes and a short walkthrough.
Service delivery pipeline
A service's delivery process from pull request to production. Covers CI checks, signed images, Argo CD, staged rollout, rollback and error-budget limits.
Works with
Blueprints is one part of Blueprintr
FAQ
Questions about Blueprints
What is a blueprint?
A document whose front page is a diagram. The canvas shows the system, each shape can hold its own markdown, tables, code and files, and the whole thing publishes to one URL.
Do I need a paid plan to publish one?
No. Blueprints are on the free plan.
Can I keep a blueprint private?
Every blueprint is public, private, unlisted or a draft. On Team you can also put a password on the ones you send to a client.
Can I put a blueprint in Confluence or a README?
Yes. One embed code works in Confluence, SharePoint, an intranet or a README, and it shows the current version rather than a screenshot taken on the day you pasted it.
What happens to the old version when I publish again?
It is kept. The history shows what changed in the document's text at each publish.
Which diagram editor does a blueprint use?
Vellum by default. Draw.io, Excalidraw and Mermaid are available too, and shapes in all four can carry a stratum.