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

1. Write your slides in markdown with --- separators
2. Build with mycuppa build slides.md
3. Serve with mycuppa serve slides.cup
4. 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