ProDeck

AI-powered slide deck generator. Drop in some reference images, describe what you want, and get back polished presentation slides, designed according to your reference materials. This also includes structurring the narrative of the presentation based on your prompt -- your prompt can be simple (system will take more creative license), or very complex/structured (system will follow your instructions re: slide-by-slide layout, text displayed, etc).

Uses Gemini 3 for planning + image generation, with optional OpenAI support.

NEW: ✨ ProDeck now includes a headless API for automated deck generation via HTTP endpoints! Perfect for agents, CI/CD pipelines, and batch processing. See Headless API Quick Start for details.

What it does

• Takes your prompt + reference images and plans out a full deck structure
• Generates each slide as a 16:9 image (not HTML, actual rendered slides)
• Mimics the style/colors and 'brand kit' from your reference images
• Exports to .pptx (not editable, but works smoothly in PowerPoint, images are high resolution).

Stack

• React + TypeScript + Vite
• Tailwind v4 + Framer Motion
• Gemini 3 (planning + images) / OpenAI gpt-image-1.5 (optional)
• PptxGenJS for export

Setup

Need Node 18+, a Gemini API key, and optionally an OpenAI key.

git clone https://github.com/fizt656/prodeck.git
cd prodeck
npm install

Create .env.local from the example:

cp .env.example .env.local
# Then edit .env.local with your actual API keys

Run it:

npm run dev

Then hit http://localhost:5173

How to use

UI Mode (Browser)

1. Write what you want the deck to be about (as detailed or as simple as you want)
2. Upload style reference images (logos, mood boards, slide template screenshots, whatever)
3. Choose the image model you want to use (make sure your api key is set)
4. Hit Generate
5. Export to pptx when done

Headless API Mode (for automation)

Generate decks programmatically via HTTP API:

# Start the API server
npm run server:dev

# Generate a deck
curl -X POST http://localhost:8787/api/deck/generate \
  -F "prompt=Q2 Board Update" \
  -F "contextFiles=@./report.pdf" \
  -F "styleImages=@./logo.png"

Or use the CLI wrapper:

./scripts/prodeck-generate.sh \
  --prompt "Product Launch Deck" \
  --docs ./specs.pdf \
  --style ./brand-kit.png

See full API documentation: Headless API Quick Start | Complete API Docs

Project Structure

ProDeck/
├── src/                    # React UI application
├── server/                 # Headless API server
│   ├── index.ts           # Express server
│   ├── services/          # AI, PPTX, orchestration
│   └── brandProfiles/     # Brand style definitions
├── shared/                # Shared types (UI + API)
├── scripts/               # CLI tools
└── docs/                  # Documentation