deck-generator

1# Deck Generator
2 
3Generate complete presentations where every slide is an AI-generated image in a consistent visual style.
4 
5## Quick Start
6 
71. Read the content spec (user provides slide content or a markdown file)
82. Read `references/styles.md` to pick or customize a visual style
93. Run `scripts/generate-deck.py` with content + style
10 
11## Workflow
12 
13### Step 1: Content Spec
14 
15Accept slide content in any format. Normalize to this structure per slide:
16- **Title**: Bold headline
17- **Body**: Key points, stats, or narrative
18- **Visual cues**: Icons, diagrams, layouts described in words
19 
20If user provides a markdown file with `---` separators, parse each section as a slide.
21If user provides a topic only, generate 10-14 slides following standard deck structures.
22 
23### Step 2: Style Selection
24 
25Available style presets:
26 
27| Style | Description |
28|-------|-------------|
29| `whiteboard` | Hand-drawn sketch on white. Black ink, orange accents. |
30| `corporate` | Navy/white/gold. Clean sans-serif. Professional. |
31| `minimalist` | Pure white, electric blue accent. Maximum negative space. |
32| `dark-tech` | Near-black background, neon green. Terminal aesthetic. |
33| `playful` | Bright pastels, rounded shapes. Modern startup vibe. |
34| `editorial` | Black/white with red spot color. Magazine aesthetic. |
35 
36Default: `whiteboard`. User can specify any preset or describe a custom style.
37 
38### Step 3: Generate
39 
40```bash
41# Set your API key
42export GEMINI_API_KEY="your-gemini-api-key"
43 
44# Run the generator
45…