ProjectBuild an Agentic Content Studio: the explanation · Module 7: The deck spec and the templates · part 9 of 22
Part 9 · Module 7: The deck spec and the templates

Module 7: The deck spec and the templates

25 min read·
About 50 minutes · Needs: Module 5 (the low-level design and data model), Module 6 (the brand kit) · Code: backend/app/schemas/deck.py, frontend/src/render/renderer.ts, frontend/src/render/text.ts, frontend/src/render/brand.ts, frontend/src/render/slides.css

Where this fits

WHERE THIS FITS Slidesmith Studio this module BROWSER React FRONT DOOR AND API nginx, FastAPI BACKGROUND AGENTS LangGraph MODELS Ollama RENDERING Playwright DATA Postgres 17 OPERATIONS evals, Docker, Cloud Run Studio app React pages /render page same renderer nginx proxy, headers Auth sessions, CSRF Brand kit onboarding, uploads Projects deck spec, edits Job runner progress over SSE Research search, facts Strategist outline Designer slide JSON Check fit, else repair LangGraph pipeline state graph, JSON repair Ideas post ideas from pillars qwen3.8:27b Ollama, local GPU Web search Ollama API Chromium render, measure Exports PDF, PNG, ZIP, HTML PostgreSQL users, decks, jobs Uploads disk or GCS Evaluation suites, gate Insights usage, timings Containers Docker Compose Deploy Cloud Run, CI/CD
This module (blue) covers the deck spec stored with each project and the one renderer that draws it in the studio and on the /render page.

Module 5, the low-level design, showed the deck spec as one JSON document in each project's row. This module opens it: what each field may hold, how the backend cleans it, and how one TypeScript renderer turns it, plus the user's brand, into slides in three templates and two formats. Every slide the user ever sees, in a thumbnail, the editor or a PDF, comes out of this code.

The rest of this project is yours to keep

This project is bought on its own, once, and stays readable afterwards, including the parts added to it later.

Or open everything with a plan