Render a FLUID contract as an interactive lineage and build graph (SVG, PNG, HTML, or Graphviz DOT).
fluid viz-graph CONTRACT [--out PATH] [--format FMT] [--theme THEME] [--plan PLAN_JSON] [options]
| Option | Description |
|---|
CONTRACT | Path to contract.fluid.yaml. |
--env | Environment overlay to apply (e.g. dev, prod). |
--plan | Optional plan.json file to overlay build actions on the graph. |
--out, --output | Output file path. Default runtime/graph/contract.svg. |
| Option | Description |
|---|
--format | Output format: dot, svg, png, html. Default svg. |
--theme | Color theme name. Default dark. |
--custom-theme | Path to a custom theme JSON or YAML file. |
--rankdir | Graph layout direction: LR, TB, RL, BT. Default LR. |
--title | Custom title for the graph. |
| Option | Description |
|---|
--show-legend | Add a legend explaining node types. |
--collapse-consumes | Collapse all consumed sources into a single node. |
--collapse-exposes | Collapse all exposed artifacts into a single node. |
--show-descriptions | Include descriptions in node labels. |
--hide-metadata | Hide domain / layer metadata tags. |
--max-label-length | Maximum label length before truncation. Default 50. |
| Option | Description |
|---|
--open | Open the output file in the default viewer when done. |
--force | Overwrite the existing output file without prompting. |
--quiet | Suppress non-error output. |
| Option | Description |
|---|
--graphviz-args ... | Extra arguments forwarded to the Graphviz dot command. |
--debug | Enable debug output and save intermediate files. |
fluid viz-graph contract.fluid.yaml
fluid viz-graph contract.fluid.yaml --format html --theme dark --open
fluid viz-graph contract.fluid.yaml --theme blueprint --show-legend
fluid viz-graph contract.fluid.yaml --plan runtime/plan.json
fluid viz-graph contract.fluid.yaml --out docs/graph.svg --title "Customer Churn Pipeline"
- Requires Graphviz on the
PATH for non-DOT outputs (brew install graphviz on macOS, apt-get install graphviz on Debian/Ubuntu). - The
graph alias also resolves to this command for backward compatibility. - See
fluid plan for a non-graphical execution preview.