infographic-creator by antvis

---
name: infographic-creator
description: Create beautiful infographics based on the given text content. Use this when users request creating infographics.
---


An infographic (Infographic) transforms data, information, and knowledge into perceivable visual language. It combines visual design with data visualization, using intuitive symbols to compress complex information and help audiences quickly understand and remember key points.

`Infographic = Information Structure + Visual Expression`

This is a task that utilizes [AntV Infographic](https://infographic.antv.vision/) to create visual infographics.

Before you start the task, you need to understand the AntV Infographic Syntax specification, including template lists, data structures, themes, and more.

## SPECs

### AntV Infographic Syntax

AntV Infographic Syntax is a mermaid-like DSL for describing infographic rendering configuration. It uses indentation to describe information, has strong robustness, and makes it easy to render infographics through AI streaming output. It mainly contains the following information:

1. template: Use template to express text information structure.
2. data: the infographic data, which contains title, desc, items, etc. The items is an array containing label, value, desc, icon, children, etc.
3. theme: Theme contains palette, font, and other styling options.

e.g.:

```plain
infographic list-row-horizontal-icon-arrow
data
  title Title
  desc Description
  items
    - label Label
      value 12.5
      desc Explanation
      icon mdi/rocket-launch
theme
  palette #3b82f6 #8b5cf6 #f97316
```

### The Syntax

- The first line starts with `infographic <template-name>`, and the template is selected from the list below (the _Available Templates_ section).
- Use blocks to describe data / theme, with two-space indentation
- Key-value pairs are expressed as "key value", and arrays are expressed as "-" items
- The icon value is provided directly with keywords or icon names (such as `mdi/chart-line`)
- `data` should contain title/desc/items (which can be omitted according to semantics)
- `data` can include `relations`/`illus`/`attributes` for graph links, illustrations, and extended fields
- `data.items` should contain id(string)/label(string)/value(number)/desc(string)/icon(string)/illus(string)/group(string)/children(object), where children represents the hierarchical structure
- `data.relations` describes graph edges with `from`/`to` plus optional `id`/`label`/`direction`/`showArrow`/`arrowType`; mermaid-style `A -> B` is supported when generating relation graphs
- For comparison templates (template names starting with `compare-`), construct exactly two root nodes and place every comparison item under them as children to keep the hierarchy clear
- For `hierarchy-structure`, `data.items` renders top-to-bottom (first item at the top) and supports up to 3 levels (root -> group -> item)
- `theme` field is for customizing the theme of the infographic, including palette, font, etc.
  e.g. dark theme with custom palette:
  ```plain
  infographic list-row-simple-horizontal-arrow
  theme dark
    palette
      - #61DDAA
      - #F6BD16
      - #F08BB4
  data
    items
      - label Step 1
        desc Start
      - label Step 2
        desc In Progress
      - label Step 3
        desc Complete
  ```
- Use `theme.base.text.font-family` to specify fonts, such as the handwriting style '851tegakizatsu'
- Use `theme.stylize` to select built-in styles and pass parameters
  Common stylization types include:
    - `rough`: Apply hand-drawn style to make graphics look like they were drawn by hand.
    - `pattern`: Apply pattern fill to add repeated pattern effects to graphics.
    - `linear-gradient` / `radial-gradient`: Apply gradient fill to add linear or radial gradient effects to graphics.

    e.g: Hand-drawn style (rough):
    ```plain
    infographic list-row-simple-horizontal-arrow
    theme
      stylize rough
      base
        text
          font-family 851tegakizatsu
    data
      items
        - label Step 1
          desc Start
        - label Step 2
          desc In Progress
        - label Step 3
          desc Complete
    ```

Typescript definition for data field:
```ts
interface Data {
  title?: string;
  desc?: string;
  items: ItemDatum[];
  relations?: RelationDatum[];
  illus?: Record<string, string | ResourceConfig>;
  attributes?: Record<string, object>;
  [key: string]: any;
}

interface BaseDatum {
  id?: string;
  icon?: string | ResourceConfig;
  label?: string;
  desc?: string;
  value?: number;
  attributes?: Record<string, object>;
  [key: string]: any;
}

interface ItemDatum extends BaseDatum {
  illus?: string | ResourceConfig;
  children?: ItemDatum[];
  group?: string;
  [key: string]: any;
}

interface RelationDatum extends BaseDatum {
  from: string;
  to: string;
  label?: string;
  direction?: 'forward' | 'both' | 'none';
  showArrow?: boolean;
  arrowType?: 'arrow' | 'triangle' | 'diamond';
  [key: string]: any;
}
```

### Icon and Illustration Resources

  **Icons (from Iconify)**:
  - Format: `<collection>/<icon-name>`, e.g., `mdi/rocket-launch`
  - Popular collections:
    - `mdi/*` - Material Design Icons (most commonly used)
    - `fa/*` - Font Awesome
    - `bi/*` - Bootstrap Icons
    - `heroicons/*` - Heroicons
  - Browse at: https://icon-sets.iconify.design/
  - Common icon examples:
    - Tech: `mdi/code-tags`, `mdi/database`, `mdi/api`, `mdi/cloud`
    - Business: `mdi/chart-line`, `mdi/briefcase`, `mdi/currency-usd`
    - Process: `mdi/check-circle`, `mdi/arrow-right`, `mdi/cog`
    - People: `mdi/account`, `mdi/account-group`, `mdi/shield-account`

  **Illustrations (from unDraw)**:
  - Format: illustration filename (without .svg), e.g., `coding`
  - Browse at: https://undraw.co/illustrations
  - Common themes:
    - Tech: `coding`, `programmer`, `server`, `cloud-sync`
    - Business: `business-plan`, `team-work`, `analytics`
    - Abstract: `abstract`, `building-blocks`, `connection`
  - Note: Use sparingly as illustrations are larger and more detailed than icons

  **Usage Tips**:
  - For `sequence-*` and `list-*` templates → use `icon`
  - For larger illustration needs → use `illus`
  - Not all templates support both icon and illus - refer to template examples

### Available Templates

- sequence-zigzag-steps-underline-text
- sequence-horizontal-zigzag-underline-text
- sequence-horizontal-zigzag-simple-illus
- sequence-circular-simple
- sequence-filter-mesh-simple
- sequence-mountain-underline-text
- sequence-cylinders-3d-simple
- sequence-color-snake-steps-horizontal-icon-line
- sequence-pyramid-simple
- sequence-funnel-simple
- sequence-roadmap-vertical-simple
- sequence-roadmap-vertical-plain-text
- sequence-zigzag-pucks-3d-simple
- sequence-ascending-steps
- sequence-ascending-stairs-3d-underline-text
- sequence-snake-steps-compact-card
- sequence-snake-steps-underline-text
- sequence-snake-steps-simple
- sequence-stairs-front-compact-card
- sequence-stairs-front-pill-badge
- sequence-timeline-simple
- sequence-timeline-rounded-rect-node
- sequence-timeline-simple-illus
- compare-binary-horizontal-simple-fold
- compare-hierarchy-left-right-circle-node-pill-badge
- compare-swot
- quadrant-quarter-simple-card
- quadrant-quarter-circular
- quadrant-simple-illus
- relation-circle-icon-badge
- relation-circle-circular-progress
- compare-binary-horizontal-badge-card-arrow
- compare-binary-horizontal-underline-text-vs
- hierarchy-tree-tech-style-capsule-item
- hierarchy-tree-curved-line-rounded-rect-node
- hierarchy-tree-tech-style-badge-card
- hierarchy-structure
- chart-column-simple
- chart-bar-plain-text
- chart-line-plain-text
- chart-pie-plain-text
- chart-pie-compact-card
- chart-pie-donut-plain-text
- chart-pie-donut-pill-badge
- chart-wordcloud
- list-grid-badge-card
- list-grid-candy-card-lite
- list-grid-ribbon-card
- list-row-horizontal-icon-arrow
- list-row-simple-illus
- list-sector-plain-text
- list-column-done-list
- list-column-vertical-icon-arrow
- list-column-simple-vertical-arrow
- list-zigzag-down-compact-card
- list-zigzag-down-simple
- list-zigzag-up-compact-card
- list-zigzag-up-simple
- relation-dagre-flow-tb-simple-circle-node
- relation-dagre-flow-tb-animated-simple-circle-node
- relation-dagre-flow-tb-badge-card
- relation-dagre-flow-tb-animated-badge-card

**Template Selection Guidelines:**
- For strict sequential order: processes/steps/development trends → `sequence-*` series
  - Timeline → `sequence-timeline-*`
  - Staircase diagram → `sequence-stairs-*`
  - Roadmap → `sequence-roadmap-vertical-*`
  - Zigzag steps → `sequence-zigzag-*`
  - Circular progress → `sequence-circular-simple`
  - Color snake steps → `sequence-color-snake-steps-*`
  - Pyramid diagram → `sequence-pyramid-simple`
- For listing viewpoints → `list-row-*` series or `list-column-*` series
- For comparative analysis (comparing pros and cons of two parties) → `compare-binary-*` series
- For SWOT analysis → `compare-swot`
- For hierarchical structure (tree diagram) → `hierarchy-tree-*`
- For data charts → `chart-*` series
- For quadrant analysis → `quadrant-*` series
- For grid lists (bullet points) → `list-grid-*` series
- For relationship display → `relation-circle-*`
- For word cloud → `chart-wordcloud`

### Example

Draw an information graph of the Internet technology evolution

```plain
infographic list-row-horizontal-icon-arrow
data
  title Internet Technology Evolution
  desc From Web 1.0 to AI era, key milestones
  items
    - time 1991
      label Web 1.0
      desc Tim Berners-Lee published the first website, opening the Internet era
      icon mdi/web
    - time 2004
      label Web 2.0
      desc Social media and user-generated content become mainstream
      icon mdi/account-multiple
    - time 2007
      label Mobile
      desc iPhone released, smartphone changes the world
      icon mdi/cellphone
    - time 2015
      label Cloud Native
      desc Containerization and microservices architecture are widely used
      icon mdi/cloud
    - time 2020
      label Low Code
      desc Visual development lowers the technology threshold
      icon mdi/application-brackets
    - time 2023
      label AI Large Model
      desc ChatGPT ignites the generative AI revolution
      icon mdi/brain
```

### Example 2: Using Illustrations

```plain
infographic sequence-horizontal-zigzag-simple-illus
data
  title Product Development Phases
  desc Key stages in our development process
  items
    - label Research
      desc Understanding user needs
      illus user-research
    - label Design
      desc Creating user experience
      illus design-thinking
    - label Development
      desc Building the product
      illus coding
    - label Launch
      desc Going to market
      illus launch-day
```
## Creation Process

### Step 1: Understanding User Requirements

Before creating the infographic, it is important to understand the user's requirements and the information they want to present. This will help in defining the template and the data structure.

If the user provides a clear and concise description of the information they want to present, break down the information into a clear and concise structure.

Otherwise, ask the user for clarification (e.g., "Please provide a clear and concise description of the information you want to present.", "Which template would you prefer to use?")

- Extract key information structure (title, description, items, etc).
- Identify the required data fields (e.g., title, description, items, labels, values, icons, etc.).
- Select an appropriate template.
- Use the AntV Infographic Syntax to describe the content of the infographic `{syntax}`.

**CRITICAL NOTE**: Must respect the language of the user's input content. e.g. if the user's input content is in Chinese, the text content in infographic syntax must be in Chinese.

### Step 2: Rendering the Infographic

Once you have the final AntV Infographic Syntax, you can generate the complete infographic HTML file by following these steps:

1. Create a complete HTML file with the following structure:
   - DOCTYPE and HTML meta tags (charset: utf-8)
   - Title: `{title} - Infographic`
   - Include AntV Infographic library script: `https://unpkg.com/@antv/infographic@latest/dist/infographic.min.js`
   - Add a resource loader script that handles icon loading from Iconify and illustration loading from unDraw
   - Create a container div with id `container` where the infographic will render
   - Initialize the Infographic instance with `width: '100%'` and `height: '100%'`
   - Replace the placeholder `{title}` with the actual title
   - Replace the placeholder `{syntax}` with the actual AntV Infographic Syntax
   - Include export functionality that allows users to download the infographic as SVG `const svgDataUrl = await infographic.toDataURL({ type: 'svg' });`

The Html template you can follow:

```html
<div id="container"></div>
<script src="https://unpkg.com/@antv/infographic@latest/dist/infographic.min.js"></script>
<script>
// Resource Loader Script
// Use the following resource loader script to handle icon and illustration loading:
const svgTextCache = new Map();
const pendingRequests = new Map();

AntVInfographic.registerResourceLoader(async (config) => {
    const { data, scene } = config;

    try {
        const key = `${scene}::${data}`;
        let svgText;

        // 1. Check cache
        if (svgTextCache.has(key)) {
            svgText = svgTextCache.get(key);
        }
        // 2. Check if request is already in progress
        else if (pendingRequests.has(key)) {
            svgText = await pendingRequests.get(key);
        }
        // 3. Make new request
        else {
            const fetchPromise = (async () => {
                try {
                    let url;

                    if (scene === 'icon') {
                        url = `https://api.iconify.design/${data}.svg`;
                    } else if (scene === 'illus') {
                        url = `https://raw.githubusercontent.com/balazser/undraw-svg-collection/refs/heads/main/svgs/${data}.svg`;
                    } else return null;

                    if (!url) return null;

                    const response = await fetch(url, { referrerPolicy: 'no-referrer' });

                    if (!response.ok) {
                        console.error(`HTTP ${response.status}: Failed to load ${url}`);
                        return null;
                    }

                    const text = await response.text();

                    if (!text || !text.trim().startsWith('<svg')) {
                        console.error(`Invalid SVG content from ${url}`);
                        return null;
                    }

                    svgTextCache.set(key, text);
                    return text;
                } catch (fetchError) {
                    console.error(`Failed to fetch resource ${key}:`, fetchError);
                    return null;
                }
            })();

            pendingRequests.set(key, fetchPromise);

            try {
                svgText = await fetchPromise;
            } catch (error) {
                pendingRequests.delete(key);
                console.error(`Error loading resource ${key}:`, error);
                return null;
            } finally {
                pendingRequests.delete(key);
            }
        }

        if (!svgText) {
            return null;
        }

        const resource = AntVInfographic.loadSVGResource(svgText);

        if (!resource) {
            console.error(`loadSVGResource returned null for ${key}`);
            svgTextCache.delete(key);
            return null;
        }

        return resource;
    } catch (error) {
        console.error('Unexpected error in resource loader:', error);
        return null;
    }
});
</script>
<script>
 const infographic = new AntVInfographic.Infographic({
    container: '#container',
    width: '100%',
    height: '100%',
  });
  infographic.render(`{syntax}`);
  document.fonts?.ready.then(() => {
    infographic.render(`{syntax}`);
  }).catch((error) => console.error('Error waiting for fonts to load:', error));
</script>
```

2. Write the HTML file named `<title>-infographic.html` using the Write tool

3. Display to the user:
   - The generated file path with instruction: "Open this file directly in a browser to view and save the SVG"
   - Display your output syntax with instruction: "If you need to adjust the template/colors/content, just let me know"

**Note:** The HTML file must include:
- Complete resource loader for handling icon and illustration assets from external sources
- SVG export functionality via the export button
- Responsive container that takes 100% width and height
- Proper error handling for failed resource loads