PPT-Design-Prompt

Convert DESIGN.md brand references into presentation-image oriented DESIGN.md files.

This repository is for slide image systems, not full slide decks, not HTML presentations, and not product UI implementation. The goal is to turn web-first brand guidance into a format that image models and design agents can use when generating assets for PowerPoint, Keynote, PDF decks, or visual essays.

This project is adapted from the upstream DESIGN.md collection maintained at VoltAgent/awesome-design-md. Its purpose is to reinterpret those web and UI oriented references as presentation-image prompts and guidance.

Upstream source

The original source catalog for this project is:

This repository is a derivative conversion tool and prompt library. It is not the original source catalog, and it should not be confused with the upstream project.

What this repo is

• a converter from source DESIGN.md files to ppt-image//DESIGN.md
• a small Python CLI that can be installed and re-run locally
• a generic presentation-image DESIGN.md at the repo root
• a minimal synthetic example for CI and contributor onboarding

What this repo is not

• not a deck generator
• not a PowerPoint exporter
• not a screenshot scraper
• not a promise that every brand source can be legally redistributed

Open-source boundary

This repository is structured so that local downloaded sources stay local by default.

• source/ is ignored by .gitignore
• local source files are expected to originate from VoltAgent/awesome-design-md
• the repository license applies to repo-authored code and docs
• third-party brand names and source materials remain the property of their owners
• if you publish converted brand outputs, review the legal notes in ATTRIBUTION.md

If your local working copy already contains a populated source/ directory, double-check it before making an initial public commit.

Repository layout

.
+-- DESIGN.md                      # generic presentation-image design guide
+-- ATTRIBUTION.md                 # licensing and provenance boundary
+-- catalog/brands.txt             # optional expected brand catalog
+-- examples/minimal/              # synthetic example fixture
+-- ppt-image/                     # generated outputs
+-- scripts/                       # convenience wrapper for repo-local runs
+-- src/awesome_design_md_ppt_images/
|   +-- cli.py
|   +-- converter.py
+-- tests/

Install

python -m pip install -e .

Quick start

If you already have local source files under source//DESIGN.md, run:

design-md-ppt convert

This writes:

• converted files to ./ppt-image
• a manifest to ./conversion_manifest.json

If you want explicit paths:

design-md-ppt convert \
  --source-root ./source \
  --output-root ./ppt-image \
  --manifest ./conversion_manifest.json \
  --brands-file ./catalog/brands.txt

Example run without