Deckmill Design Guide
Deckmill is a Rust-native carousel generation engine and MCP server that produces pixel-perfect social media carousels using the embedded Blitz rendering engine (stylo layout + vello raster — no browser dependency) and a full design system derived from perceptual color science (OKLCH).
Architecture
configure_design → generate_slide(s) → render_carousel → export_carousel_slides
configure_design — Derives a full design token set (palette, typography, spacing, effects) from a single hex brand color using Material Color Utilities / OKLCH math. Saves all session context (brand name, handle, platform, archetype, theme).
generate_slide — Generates self-contained HTML for a single slide using the configured design tokens and a slide type dispatcher.
render_carousel — Assembles individual slide HTML into a full multi-slide HTML document with Google Fonts, CSS variables, progress indicators, and brand footer.
export_carousel_slides — Uses the embedded Blitz renderer (stylo layout + vello-cpu raster) to render each slide as a PNG at the target platform resolution. No browser subprocess; peak RSS ~110 MB vs ~550 MB for Chrome.
Slide Types
Visual Themes
Background Styles
light — Light surface with subtle mesh gradient
dark — Dark surface with floating shapes
hero — Dark gradient from primary to dark
gradient — Colorful linear gradient
Archetypes
Best Practices
- Always call
configure_design first before generating slides
- Use
list_slide_types to discover available slide types
- Use
validate_layout before rendering to catch missing params
- For dark slides (
dark, hero, gradient), glass effects are automatically applied
- Use
recommend_color_scheme to explore palette variations before committing
- The
archetype setting controls default variants and styling for all slides in the session
- For Instagram carousels, 6-8 slides is optimal. Always end with a CTA slide.
Example Workflow
// 1. Configure design
{ "tool": "configure_design", "primary_color": "#4F46E5", "visual_theme": "bold", "platform": "instagram_portrait", "archetype": "startup_pitch" }
// 2. Generate slides
{ "tool": "generate_slide", "slide_type": "hero", "params": { "headline": "10x Your Growth", "badge": "New" } }
{ "tool": "generate_slide", "slide_type": "stat_row", "params": { "title": "The Numbers", "stats": [{"value": "10×", "label": "ROI"}, {"value": "98%", "label": "Satisfaction"}] } }
{ "tool": "generate_slide", "slide_type": "cta", "params": { "headline": "Start Today", "button_text": "Get Access" } }
// 3. Render carousel
{ "tool": "render_carousel", "slides": [...], "output_path": "carousel.html" }
// 4. Export PNGs
{ "tool": "export_carousel_slides", "html_path": "carousel.html", "output_dir": "./slides", "total_slides": 6 }