How to use the AWS Step Functions visualizer
1. Paste an ASL definition
Insert Amazon States Language JSON from a Step Functions state machine. The tool parses states, transitions, choices, parallel branches, and retry policies where supported.
2. Follow the rendered flow
States appear as nodes with edges showing Next transitions, Choice branches, and Parallel segments. Use the graph to sanity-check orchestration logic before deployment.
3. Iterate on error handling
Adjust Catch and Retry blocks in the JSON, then confirm the visual flow reflects fallback paths and terminal failure states.
4. Export for design docs
Save SVG or PNG snapshots when writing runbooks or sharing state machine behavior with stakeholders who prefer diagrams over raw JSON.
Common use cases
Serverless workflow design
Draft order fulfillment, media processing, or ETL pipelines and validate branching before creating resources in AWS.
Code review support
Attach exported graphs to pull requests so reviewers see how new Task states fit into existing machines.
Operations training
Help on-call engineers understand which states execute synchronously versus asynchronously during incidents.
Compliance documentation
Show audit reviewers explicit decision points and failure handling for regulated workflows.
Refactoring legacy ASL
Visualize deeply nested Choice states when simplifying machines into smaller reusable segments.
Frequently asked questions
- Does this deploy to AWS?
- No. It is a read-only visualizer for ASL JSON you paste locally.
- Are Map and Parallel states supported?
- Common state types including Task, Choice, Parallel, Pass, Wait, and Succeed/Fail render in the graph. Unsupported or invalid JSON shows parser errors.
- Can I trace execution history?
- This tool visualizes definition structure, not live execution logs. Use AWS Console execution history for runtime traces.
- Is my state machine JSON sent to a server?
- No. Parsing and rendering remain entirely client-side.