Skip to content

Blueprint guide ​

Blueprint connects your business model to data, actions, and screens. Define the model once, then extend it as your application grows.

The core ideas ​

Each idea is explained, with a batch-production example, in core concepts.

IdeaIn one line
EntityA thing with an identity, such as a batch or a piece of equipment.
FacetOne aspect of a thing. Another module can add one through a descriptor.
RelationshipHow things connect: a batch runs on equipment and consumes material lots.
Action and ruleThe only way to change, and when the change is allowed.
LifecycleThe states a thing moves through.
Trigger, effect, task and workflowWhat starts an action, what it asks for next, and work for people.
Ledger and revisionsWho did what, when, and why; and which governed revision applied.
Module, configuration, evolutionHow the model is assembled, varied per site, and changed safely.

Then read Why Blueprint, the three planes, and connected applications. The primitives catalog shows what runs today.

Build your first application ​

  1. Request package access.
  2. Choose the packages you need from the package map.
  3. Follow developer setup and the tutorial.
  4. Start your app with the CLI.

Keep working ​

Use development profiles to run your app and servers together. See developer commands for migrations and seed files, and errors and remedies when something goes wrong.