Help

Frequently Asked Questions

Everything you need to know about SymFlowBuilder.

Do I need an account to use the editor?

No. The editor is fully public — you can design workflows, export YAML, and import existing files without creating an account. Signing in unlocks cloud save, versioning, sharing, and collaboration.

What Symfony versions are supported?

SymFlowBuilder supports Symfony 5.4, 6.4, 7.4, and 8.0. The exported YAML is version-aware and generates the correct configuration structure for your selected version.

What is the difference between a workflow and a state machine?

In Symfony, a workflow allows an entity to be in multiple places simultaneously, while a state machine restricts it to exactly one place at a time. State machines are simpler and more common for basic approval flows.

Can I import my existing Symfony workflow YAML?

Yes. Drag and drop a YAML file onto the canvas or use the Import button in the toolbar. SymFlowBuilder parses the YAML and renders the graph with automatic layout positioning.

How does guest persistence work?

When you use the editor without signing in, your workflow is automatically saved to your browser's localStorage. If you sign in later, your draft is migrated to cloud storage.

Can I share a workflow with specific people?

Yes. Authenticated users can invite collaborators by email. Collaborators can be given viewer (read-only) or editor (read-write) access. This is separate from the public sharing link.

What is a public sharing link?

Owners can generate a public link that lets anyone view a read-only version of the workflow and export its YAML — no account required. Public workflows also appear on the Explore page.

Can I undo changes?

Yes. The editor maintains a 50-step undo/redo history. Use Cmd+Z (or Ctrl+Z) to undo and Cmd+Shift+Z (or Ctrl+Shift+Z) to redo.

What are guards?

Guards are Symfony ExpressionLanguage expressions that must evaluate to true for a transition to be allowed. For example, is_granted("ROLE_ADMIN") restricts a transition to admin users.

Is SymFlowBuilder open source?

Yes. SymFlowBuilder is MIT licensed and the source code is available on GitHub. Contributions are welcome.

Where is my data stored?

Guest workflows are stored locally in your browser. Authenticated users' workflows are stored in a PostgreSQL database. We do not sell or share your data.

Can I self-host SymFlowBuilder?

Yes. The project includes deployment scripts for VPS hosting with PM2, Nginx, and PostgreSQL. Check the README for setup instructions.