Cuppa Studio Documentation
Everything you need to build developer presentations with markdown.
What is Cuppa Studio?
Cuppa Studio is a developer-first presentation tool that turns markdown into animated, timeline-driven slides. Write your content in markdown, and Cuppa Studio handles layouts, themes, animations, and transitions.
Quick Start
npx mycuppa init my-talk
cd my-talk
mycuppa build slides.md
mycuppa serve slides.cup
Core Concepts
The .cup Format
A .cup file is a ZIP archive containing JSON — like .pptx, but for developers:
| File | Purpose |
|---|
manifest.json | Title, author, scene count |
content.json | Scenes, elements, layout |
timesheet.json | Animation timeline, markers |
theme.json | Colors, fonts, typography |
Workflow
- Write your slides in markdown with
--- separators - Build with
mycuppa build slides.md - Serve with
mycuppa serve slides.cup - Present in any browser — keyboard navigation, presenter view, slide overview
Explore
- Getting Started — Set up your first presentation
- AI Guide — Write effective prompts for AI generation
- MCP Setup — Connect Cuppa Studio to Claude, Cursor, Windsurf, and more
- Format Reference — All element types, layouts, and directives
- CLI Reference — Commands and options
- Themes Gallery — 8 built-in themes
- Embedding — Embed presentations anywhere
- Cloud Features — Sign in to sync projects across devices, upload images to your library, and manage your subscription
