Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.iblueprint.ai/llms.txt

Use this file to discover all available pages before exploring further.

iBlueprint tracks every significant change to a Blueprint as a numbered version, giving you a complete audit trail and the ability to roll back, compare, or branch off from any point in the Blueprint’s history. Versions follow semantic versioning (major.minor.patch) so the version number communicates the impact of each change at a glance.

How versioning works

Each Blueprint starts at version 1.0.0. When you save a new version, you choose one of three bump types:
Bump typeWhen to useExample
patchSmall fixes — typos in prompts, minor config tweaks1.0.01.0.1
minorNew nodes added or non-breaking config changes1.0.01.1.0
majorBreaking changes — restructured chain, removed nodes, changed variable names1.0.02.0.0
The currently active version is always the latest one. You cannot roll back to a previous version by default, but you can view any historical snapshot and use it to manually restore configuration.

Saving a new version

1

Make your changes

Edit nodes, update configurations, or rearrange the chain in the Blueprint editor. Your changes are auto-saved as a draft and do not create a new version yet.
2

Open the Version dialog

Click Save version in the top toolbar (or press Ctrl+Shift+S). The version dialog appears showing the current version number.
3

Choose a bump type

Select patch, minor, or major depending on the nature of your changes.
4

Add a changelog entry (optional)

Write a short note describing what changed. This appears in the version history and is visible to collaborators and, for public Blueprints, to Marketplace users.
5

Confirm

Click Save. iBlueprint computes the new version number, saves a full snapshot of the Blueprint map, and records the changelog entry.

Viewing version history

Open the History panel from the Blueprint editor sidebar to see a chronological list of all saved versions. Each entry shows:
  • The version number (e.g. 2.1.0)
  • The timestamp and the user who saved it
  • The changelog note (if one was provided)
Click any version to preview its Blueprint map in a read-only view. You can copy configuration from a historical version and paste it into the current editor if you need to restore a specific node or setting.

Forking a Blueprint

Forking creates a fully independent copy of a Blueprint under your account. The fork starts at version 1.0.0 and has no ongoing link to the original — changes to either Blueprint do not affect the other.
1

Open the Blueprint menu

From the Blueprint list or inside the editor, click the menu on the Blueprint you want to fork.
2

Select Fork / Duplicate

Click Fork (for public or shared Blueprints) or Duplicate (for your own Blueprints). Both actions produce the same result — a new independent copy.
3

Name the fork

Enter a title for the new Blueprint. The default is [Original title] (Copy).
4

Confirm

Click Create. The new Blueprint opens in the editor. It inherits the source Blueprint’s node map and environment variable names (but not environment variable values, which must be re-entered).
Forking is the recommended way to experiment with a published Blueprint without risking the original. It is also how other users build on Blueprints they discover in the Marketplace.

Blueprint visibility

Every Blueprint has a visibility setting that controls who can see and run it:
VisibilityWho can access
privateOnly you and invited collaborators
publicAnyone — the Blueprint appears in the Marketplace and can be forked by any iBlueprint user
You can change visibility at any time from Blueprint settings → Visibility.
Setting a Blueprint to public makes its full node map (including system prompts and non-secret configuration) visible to all users. Before publishing, replace any sensitive values with environment variable references and remove any proprietary content from node configs.

Publishing to the Marketplace

Publishing a Blueprint makes it discoverable in the iBlueprint Marketplace, where other users can find it, run it directly, or fork it as a starting point for their own work.
1

Save the version you want to publish

Make sure the Blueprint is in a stable state and save it as a named version. Published Blueprints should have a changelog so users understand what the Blueprint does.
2

Set visibility to public

In Blueprint settings, change Visibility to Public.
3

Fill in Marketplace metadata

Add a clear description, relevant tags, and a cover image. Blueprints with complete metadata surface higher in Marketplace search results.
4

Publish

Click Publish in the Blueprint settings panel. The Blueprint appears in the Marketplace immediately. Its status moves from draft to published.
Publishing does not lock the Blueprint. You can continue editing and saving new versions after publishing. Marketplace users always see the latest published version.

Blueprint status reference

StatusDescription
draftWork in progress. Private by default; not listed in the Marketplace.
publishedReleased and visible according to its visibility setting. Can be private (shared with collaborators) or public (listed in the Marketplace).