The Wizard Builder is the full-screen editor for creating and modifying wizard templates, including steps, fields, branching conditions, validation rules, and publishing. Primary route:Documentation Index
Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
Use this file to discover all available pages before exploring further.
/platform/wizards/builder/:id. Also accessible at /platform/wizards/builder (no ID, for new wizards).
Overview
The builder page resolves the:id param and loads the template via useWizardTemplateDetail. A cooperative locking mechanism (useWizardLock) prevents simultaneous edits: if another user holds the lock, LockConflictDialog is shown offering Retry or Start Fresh options.
The WizardBuilder component provides the full editing canvas with step management, field configuration, validation rules (ValidationRuleBuilder), branching (BranchEditor), and live preview (WizardPreview). Publishing creates a new version via PublishVersionDialog.
Who it’s for
Requirespf.wizards.admin (route guard for the builder route). The wizard list route at /platform/wizards checks PERMISSIONS.PF.WIZARDS_CREATE for the New Wizard action.
Before you start
- You must have
pf.wizards.adminto reach the builder. - For an existing wizard, navigate from the Wizard Templates list (
/platform/wizards). - For a new wizard, click New Wizard from the list page.
Steps
- Navigate to
/platform/wizardsand click a template, or click New Wizard. - The builder loads with the template (or a blank canvas for new).
- Add and configure steps using the step panel.
- Add fields to each step and configure field properties.
- Set up branching logic and validation rules as needed.
- Preview the wizard using the live preview panel.
- Click Publish to create a new published version.
Key concepts
Step — a single page in the wizard flow; each step has a title, icon, and one or more fields. Branch — conditional logic that routes users to different steps based on field values. Lock — a cooperative editing lock that prevents two users from editing the same wizard simultaneously. Version — each publish creates a new numbered version; prior versions remain accessible.Related
Platform Foundation
Platform Foundation overview.
Governance & parity
This page documents shipped product behavior. It is not medical, legal, or
billing advice. Verify against your organization’s policies and applicable
regulations before using it for clinical, compliance, or billing decisions.
Protected health information (PHI) shown in the product is governed by your
tenant’s access controls and is never exposed in this documentation.
Documentation sources
Documentation sources
- src/routes/platform.tsx
- src/platform/wizards/pages/WizardBuilderPage.tsx
- src/platform/wizards/components/WizardBuilder.tsx
- src/platform/wizards/hooks/useWizardLock.ts
- src/platform/wizards/components/LockConflictDialog.tsx