Generating Infographics

Generate branded infographics with custom themes and backgrounds using @antv/infographic.

Prerequisites

1. •Run /brand-init to create project structure
2. •Run /brand-extract to generate brand-philosophy.md
3. •Run /template-infographic to create an infographic template

When to Use

• •"Create an infographic"
• •"Make a process diagram"
• •"Visualize this data"
• •"Create a timeline"
• •"Show comparison infographic"
• •NOT for: Charts/graphs (use charting library), presentations (use visual-content skill)

Commands

Template Categories (114 Total)

Template Asset Types

Recommendation: Start with text-only templates. Illustrated templates require custom image files.

Illustrated Template Workflow

When using -illus templates:

1. •Content includes illus field referencing image filename
2. •Supported formats: SVG (recommended), PNG, JPG
3. •Options: provide your own images, find icons, or use placeholders
4. •Images stored with infographic output: infographics/{date}-{name}/illustrations/
5. •See references/illustrations.md for detailed workflow

Text Guidelines (Avoiding Overlap)

If overlap occurs: shorten text, use wider canvas (1200px+), or use column/grid templates.

Quick Reference

Background Presets

Layered (gradient + pattern):

Simple (gradient or pattern only):

Workflow

1. Create Template (once)

/template-infographic

Select: category → design → palette → background → style

2. Generate Infographic (repeat)

/infographic-quick

Select template → paste content → name → get PNG

Accessibility & Readability (MANDATORY)

These checks are NON-NEGOTIABLE before generating any infographic.

Contrast Validation (WCAG AA)

Key principle: Palette colors are for SHAPES and FILLS, not text. Text needs explicit high-contrast colors.

Text Color Rules by Background

Never use palette colors for text - they're for decorative shapes only.

Spacing & Balance Rules

Pre-Generation Checklist

□ All text has 4.5:1 contrast against background
□ Labels are 1-2 words (no overlap risk)
□ Descriptions are 2-4 words
□ Content fits template capacity (check item limits)
□ Dark bg → white text, Light bg → dark text
□ No text touching edges

If ANY check fails, DO NOT generate. Fix the content or config first.

Config Examples

Dark Backgrounds (spotlight-dots, tech-matrix, etc.)

{
  "colorBg": "#0D2B5C",
  "colorPrimary": "#60A5FA",
  "title": { "fill": "#FFFFFF" },
  "desc": { "fill": "rgba(255,255,255,0.85)" },
  "item": {
    "label": { "fill": "#FFFFFF" },
    "desc": { "fill": "rgba(255,255,255,0.7)" }
  }
}

Light Backgrounds (solid, subtle-dots, etc.)

{
  "colorBg": "#FFFFFF",
  "colorPrimary": "#3B82F6",
  "title": { "fill": "#1A202C" },
  "desc": { "fill": "#4A5568" },
  "item": {
    "label": { "fill": "#1A202C" },
    "desc": { "fill": "#4A5568" }
  }
}

Common mistake: Using pastel palette colors for text on light backgrounds. Pastels are for decorative shapes only.

See template-infographic.md for complete config examples.

Data Structure by Type

Sequence/List

{
  "title": "Our Process",
  "items": [
    { "label": "Step 1", "desc": "Discovery" },
    { "label": "Step 2", "desc": "Design" }
  ]
}

Compare

{
  "title": "Before vs After",
  "items": [
    { "label": "Before", "children": [{ "label": "Slow" }] },
    { "label": "After", "children": [{ "label": "Fast" }] }
  ]
}

Hierarchy

{
  "title": "Organization",
  "items": [{
    "label": "CEO",
    "children": [{ "label": "CTO" }, { "label": "CFO" }]
  }]
}

Common Mistakes

References

• •references/templates.md - Complete 114 template catalog with asset requirements
• •references/theming.md - Theme configuration details
• •references/backgrounds.md - Background customization guide
• •references/icons.md - Available icons for icon-based templates
• •references/illustrations.md - Illustrated template workflow and SVG requirements

Module Structure

lib/
├── renderer.js       # Main entry point
├── dom-setup.js      # JSDOM environment
├── infographic.js    # Infographic creation
├── exporter.js       # SVG/PNG export
├── backgrounds.js    # Gradient/pattern backgrounds
└── icons.js          # Icon utilities