Modern Graphics Generator

Build hero slides, insight cards, and diagrams from one CLI with clarity-first defaults.

What You Can Build

Insight Card	Key Insight Quote	Insight Story

Hero	Triptych Hero	Open Canvas Hero

Cycle Diagram	Timeline Diagram	Slide Cards

Canonical showcase assets live in examples/output/showcase/.

Quick Switch (Jobs To Be Done)

• Use the package
• Make graphics
• Build a custom theme (font/colors)
• Build a super custom hero
• Call the CLI directly

First Commands (Most Common Jobs)

Make graphics (about 3 minutes)

modern-graphics create \
  --layout hero \
  --headline "Execution scales. Judgment does not." \
  --png \
  --output ./output/hero.png

Expected output: ./output/hero.png.

Build a custom theme (about 8 minutes)

python scripts/custom_template.py

Expected output: dark_cycle_example.html.

Start Here

Install dependencies once:

pip install playwright pillow python-dotenv
playwright install chromium

Generate a first PNG:

modern-graphics create \
  --layout hero \
  --headline "Execution scales. Judgment does not." \
  --png \
  --output ./output/hero.png

Expected output: ./output/hero.png.

Defaults (good for most first runs):

• theme=corporate
• density=clarity
• crop-mode=safe
• padding-mode=minimal

Choose Your Path

Use the package (2 minutes)

• Start here: docs/QUICKSTART.md
• API surface: docs/API.md

Make graphics (3 minutes)

• Runnable examples: examples/README.md
• Diagram/layout catalog: docs/DIAGRAM_TYPES.md
• Curated tracked outputs: examples/output/showcase/

Build a custom theme (font/colors) (8 minutes)

• Theme and template customization: docs/ADVANCED.md#custom-templates
• Export/crop/padding tuning: docs/EXPORT.md

Build a super custom hero (10 minutes)

• Hero composition patterns: docs/HERO_SLIDES.md
• Mermaid and SVG embedding: docs/MERMAID.md
• SVG.js and freeform extension: docs/ADVANCED.md#svgjs-integration

Call the CLI directly (5 minutes)

• Canonical command + recipes: docs/CREATE_COMMAND.md
• Migration from legacy commands: docs/MIGRATION.md
• Deprecation policy: docs/DEPRECATION_POLICY.md

Full docs map: docs/README.md

Contributing

• Contribution guide: docs/CONTRIBUTING.md
• Strategy and overhaul context: docs/OVERHAUL_SPEC.md

License

MIT License.