vizcharter_create
Generate presentation-ready architecture diagrams, charts, KPI dashboards, and infographics from a JSON spec, with auto-layout, themes, and export to SVG, PNG, JPG, or PDF.
Instructions
Render a VizCharter diagram from a spec and export it. Returns a PNG preview (look at it and iterate!), written file paths, embed snippets, and lint findings. Spec family 'architecture': { family:'architecture', title?, subtitle?, theme? (vizcharter-light|vizcharter-dark|aws), direction? ('AUTO' default — lays out both ways and keeps the tighter canvas | 'DOWN' | 'RIGHT'), nodes:[{id, icon? (registry id, see vizcharter_icons), label, sublabel?, parent? (container id), pin?:{x,y}}], containers:[{id, type:'region'|'account'|'vpc'|'subnet'|'az'|'layer'|'group', label, parent?}], edges:[{from, to, kind?:'sync'|'async'|'config'|'data', label?}], callouts?:[{n, at}], legend?:boolean }. Layer containers auto-rotate pastel tints; edge kinds get distinct styling and an auto legend. Spec family 'chart': { family:'chart', type:'bar'|'bar-stacked'|'bar-grouped'|'line'|'area'|'donut'|'pie'|'rose'|'venn'|'kpi', title?, theme?, width?, height?, categories?+series? (axis types), slices? (donut/pie/rose), sets?+overlaps? (venn, 2-3 sets), tiles? (kpi: {label, value, delta?, sublabel?}), options?: { showValues?, showLegend?, donutLabel? } } — same design tokens as diagrams. Spec family 'canvas' (infographics/posters): { family:'canvas', theme?, page?:{width,height,background?}, template?:{name, slots} (see vizcharter_templates; auto-sizes the page), layers?:[ {kind:'text', x,y,width?,text,style?,align?} | {kind:'shape', shape:'rect'|'circle'|'line', ...} | {kind:'icon', icon,x,y,size} | {kind:'chart', x,y,spec} | {kind:'arch', x,y,scale?,spec} | {kind:'svg', x,y,content} (raw-SVG escape hatch) ] — embed full chart/architecture specs into posters. ALL families accept an optional meta footer block, rendered as an elegant hairline band: { author?, org?, project?, version?, date?, classification? (outlined chip, e.g. 'Confidential'), source? (attribution line), note? } — use it when the user asks for authorship, versioning, dates, classification, or source attribution on a deliverable. Files land in /diagrams// including the re-editable .vizc.json source.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Diagram name — used for the output directory and file names | |
| spec | Yes | The diagram spec (family 'architecture') | |
| formats | No | Export formats (default: svg, png) | |
| out_dir | No | Base output directory (default: current working directory) | |
| png_scales | No | PNG scale factors, 0.25–4 (default: [1, 2]) | |
| preview_only | No | Render the preview without writing any files |