Cuppa Studio CLI

Developer-first presentation tool — turn markdown into animated slides.

"Right on cue."

Quick Start

# Create a new presentation
mycuppa init my-talk

# Build to .cup file
mycuppa build slides.md

# Start dev server with hot reload
mycuppa serve slides.md

# Export to standalone HTML
mycuppa export slides.cup --out talk.html

Commands

| Command | Description | |---------|-------------| | init [name] | Create a new presentation project | | build <file.md> | Compile markdown to .cup file | | serve <file> | Dev server with hot reload | | validate <file> | Validate a presentation | | export <file> | Export as HTML or PDF | | ai <prompt> | Generate a presentation with AI | | preview <url> | Preview a GitHub README (experimental) |

The .cup Format

A .cup file is a ZIP archive containing:

presentation.cup
├── manifest.json    # Metadata (title, author, scene count)
├── content.json     # Scenes and elements
├── timesheet.json   # Animation timeline
└── theme.json       # Colors, fonts, typography

Markdown Authoring

Write slides in markdown with --- separators:

---
title: My Talk
author: Jane
theme: dark
---

# Welcome

### A presentation built with Cuppa Studio

---

## Key Points

- Markdown-first authoring
- Timeline-driven animations
- AI-powered generation

---

## Code Example

` ` `typescript
function greet(name: string) {
  return `Hello, ${name}!`;
}
` ` `

Requirements

• Node.js >= 20
• Optional: playwright for PDF export
• Optional: Anthropic API key for AI generation