Skip to content

nolangz/data2motion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Data2Motion - AI Data Animation Skill for Animated Charts

GitHub stars GitHub forks Codex Skill Standalone HTML

Data -> chart -> motion -> standalone HTML.

SEO landing page · README preview · Chart motion atlas · Spec format · Skill instructions · Reference sibling: Pixel2Motion

Data2Motion is an AI data animation skill for turning JSON data, KPIs, rankings, trends, and small datasets into polished animated chart HTML. This repository ships the Lite engine: a script-driven Codex and Claude skill that takes one compact JSON spec, chooses from a fixed chart vocabulary, and exports a dependency-free HTML file with the Data2Motion house style, replay controls, reduced-motion support, and deterministic QA hooks.

中文:Data2Motion 的 Lite 版本是一个把数据变成动态图表 HTML 的 AI skill。你只需要给出数据和图表类型,脚本负责版式、颜色、动效、控制条和可复现渲染,适合快速把一个数字、趋势、排名、对比或占比做成可上线的 data story。

Recommended review order: the README preview page, the chart motion atlas, the example outputs, and then the spec format.

Data-to-Motion Gallery

Open the local preview page at showcase/index.html to browse the launch-style README page, built examples, and visual templates. Open docs/index.html for the SEO landing page intended for GitHub Pages.

Motion output What it demonstrates
examples/kpi_arr.html One big KPI number with a small supporting trend.
examples/multiline_biomass.html Multi-line comparison with direct labels and smooth draw-on motion.
showcase/chart-motion-atlas.html Essential dark-console chart and motion vocabulary.
showcase/packages/ft.html Light editorial FT-style template for poster-like data stories.

Why Lite

A text-only model cannot reliably inspect its own visual output. Data2Motion Lite moves the look and motion into scripts/build.py, so the agent writes only a small JSON spec and the script owns the rendering.

The result is intentionally constrained:

  • One JSON file in, one standalone HTML file out.
  • No hand-authored HTML, CSS, SVG, or animation per chart.
  • A fixed chart vocabulary: kpi, bar, column, diverging, line, multiline, area, stacked, scatter, lollipop, dumbbell.
  • Two launch-ready styles: essential dark console and ft light editorial.
  • Built-in replay, speed, freeze, ?static=1, and ?t=<ms> hooks.

Deliverables

  • chart_motion.html: standalone animated chart page generated from a JSON spec.
  • spec.json: the data, chart type, title, takeaway, source, unit, duration, style, and optional scale settings.
  • showcase/index.html: README-style launch page for presenting the project.
  • docs/index.html: SEO landing page and waitlist entry for Data2Motion and the upcoming commercial motion platform.
  • showcase/chart-motion-atlas.html: Essential house-style reference.
  • showcase/packages/ft.html: FT-style reference template.
  • references/spec.md: the contract every input spec follows.

Workflow

  1. Read references/spec.md and pick the closest chart type.
  2. Write a compact JSON spec with real numbers and a source.
  3. Build the output:
python3 scripts/build.py examples/kpi_arr.json chart_motion.html
  1. Open chart_motion.html in a browser.
  2. Use ?static=1 for the final frame or ?t=<ms> for deterministic frame checks.

Example Spec

{
  "chart": "kpi",
  "title": "ARR reached $12.4M",
  "takeaway": "ARR climbed 42% year over year after the enterprise launch.",
  "source": "Company dashboard - FY2026",
  "unit": "M",
  "value_format": "0.0",
  "value": 12.4,
  "kpi_label": "annual recurring revenue",
  "sparkline": [7.1, 8.3, 9.6, 10.8, 12.4],
  "duration": 1400,
  "style": "essential"
}

How It Differs From Full Data2Motion

Data2Motion full Data2Motion Lite
Target model Strong multimodal agent Any text-only agent
Chart selection Guided by editorial and perceptual rules User or agent picks from a fixed list
Motion design Brief-led choreography and visual QA Encoded in the generator
Output Full data-motion package with evidence One spec and one HTML output
Best use High-stakes custom data story Fast, repeatable animated chart

Requirements

  • Python 3.10+
  • A modern browser for viewing generated HTML
  • Optional: Chrome or Playwright if you want deterministic screenshots from ?static=1 and ?t=<ms>

No runtime JavaScript dependencies are required in the generated chart HTML.

Repository Layout

  • SKILL.md: Codex-facing instructions for using this skill.
  • scripts/build.py: deterministic chart-to-HTML generator.
  • references/spec.md: accepted JSON schema and chart examples.
  • examples/: ready-to-run input specs and generated outputs.
  • showcase/: README preview, chart-motion atlas, FT-style template, and publishable assets.
  • docs/: GitHub Pages SEO landing page, crawler metadata, and waitlist assets.

GitHub SEO

Recommended GitHub About settings:

  • Description: AI data animation skill that turns JSON data into standalone animated chart HTML for data storytelling, dashboards, reports, and launch visuals.
  • Website: https://nolangz.github.io/data2motion/
  • Topics: data-visualization, animated-charts, data-storytelling, dataviz, svg-animation, html-animation, ai-tools, generative-ai, codex-skill, claude-skill, charts, dashboard, reporting, storytelling, github-pages, javascript, python

Search keywords this repository intentionally targets: AI data animation, animated charts, data storytelling, chart motion, data visualization animation, standalone chart HTML, SVG chart animation, Codex skill, Claude skill, and JSON to chart.

Publishing Checklist

  • Confirm README.md, SKILL.md, references/, scripts/, examples/, and showcase/ are committed.
  • Keep caches, local virtual environments, generated temp frames, and dependency directories out of git.
  • Enable GitHub Pages from branch main, folder /docs, to publish the SEO landing page.
  • After creating the GitHub repository, add the remote and push:
git remote add origin git@github.com:<owner>/data2motion-lite.git
git branch -M main
git push -u origin main

More From Nolanlai

nolanlai.com

vibe-creators group QR code

扫码进群交流 vibe-creators群
Scan the QR code to join the vibe-creators group.

Built with Codex.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors