Command Line
Render
xaligo render <file.xal> --format <format> -o <output>
Supported formats:
| Format | Output |
|---|---|
excalidraw | Editable Excalidraw JSON |
svg | Standalone SVG |
pptx | PowerPoint presentation |
xyflow | React Flow / XYFlow JSON |
isoflow | Isoflow-compatible model JSON |
Common render flags:
| Flag | Description |
|---|---|
| `--mode standard | network |
| `--theme light | dark` |
--services <csv> | Service metadata and label overrides |
| `--svg-legend-position top | right |
PPTX-specific flags:
| Flag | Description |
|---|---|
| `--paper A5 | A4 |
| `--orientation portrait | landscape` |
--paper-margin <inches> | Margin applied before fitting |
--paper-margin-top/right/bottom/left <inches> | Per-side margin override |
--px-per-inch <number> | Layout scaling base |
--title, --author, --company, --subject | Presentation metadata |
| `--compression true | false` |
Generate
Generate a starter .xal hierarchy:
xaligo generate xal -o generated.xal --paper A4 --orientation landscape
Useful generation flags:
| Flag | Description |
|---|---|
--clouds, --accounts, --regions, --azs | AWS hierarchy counts |
| `--az-layout grid | staggered` |
--subnets | Number of subnets |
| `--spacing vertical | horizontal |
| `--start top | left` |
Other Commands
| Command | Description |
|---|---|
xaligo validate <file.xal> | Validate syntax, layout, and connection references |
xaligo serve <file.xal> | Serve an SVG live preview |
xaligo add service --name <name> --file <file> | Add a service icon |
xaligo add service --list <csv> --file <file> | Bulk-add service icons |
xaligo init [-o <dir>] | Generate a sample .xal file |
xaligo version | Print version |