Back to Logbook

Mission · cuppa.studio

cuppa.studio: where a prompt becomes a presentation


You only know what you are doing when you can present and articulate your idea and solution to others clearly.

That belief is the foundation of cuppa.studio. The ability to explain — to your team, your stakeholders, or yourself — is what separates knowing something from understanding it. And yet the tools developers reach for when they need to do that are fundamentally broken.

YouTube is broken for learning

Millions of developers turn to YouTube to learn new technologies. It’s the default. But video is a terrible medium for structured technical learning:

YouTube works for entertainment. It works for vibe. It fails the moment a developer needs to deeply understand and apply.

Slides are broken for developers

On the creation side, developers avoid making presentations because the tools were designed for salespeople. PowerPoint and Keynote are drag-and-drop visual editors that feel alien to anyone who thinks in text. Slidev and reveal.js are developer-friendly to author but ship with poor defaults, no AI, and no animation intelligence.

The result: developers either skip presentations entirely — losing the forcing function of clear articulation — or spend hours fighting tools that weren’t built for code, diagrams, and terminal output.

The gap

YouTube (passive, unstructured, video)

    [ THIS GAP ]  ← cuppa.studio

Documentation (dense, reference-only, no narrative)

cuppa.studio fills it: structured, interactive, AI-native presentations that developers can create in minutes and learn from in a way video never allows.

How the IDE works

Open cuppa.studio. The studio splits into two panes — a markdown editor on the left, a live, animated preview on the right. Type a prompt:

“A 12-slide intro to autonomous AI agents for senior engineers. Cover memory architecture, tool calling, and orchestration with code examples.”

The AI generates a complete deck — title, slides, transitions, syntax-highlighted code, mermaid diagrams, charts — in seconds. Refine with follow-up instructions: “add a slide about output repair”, “replace slide 4 with a sequence diagram”. Each refine is incremental; the rest of the deck stays put.

When you’re ready, hit play. Auto Drive narrates every slide with AI-generated voice — your audience can sit back and listen, or step through at their own pace. Or share with a link: anyone can view, no account, no install.

What you write

The source format is plain markdown with a few extensions for slide structure. Here’s roughly what the AI produces (and what you can edit):

# Building AI Agents

A software engineer's introduction to autonomous systems.

---

## Memory Architecture

Short-term and long-term context strategies for production agents.

```python
from langchain.memory import ConversationBufferMemory

conversation_memory = ConversationBufferMemory(
    memory_key="chat_history",
    return_messages=True,
    k=10,  # Last 10 exchanges
)
```

::: speaker
The short-term buffer keeps the last N exchanges in working memory.
For long-term recall, we vectorize past conversations and pull
back semantically relevant ones at retrieval time.
:::

The :::speaker block is the narration that Auto Drive reads. The fenced code block becomes a syntax-highlighted, animated typing effect. Mermaid diagrams animate node-by-node. There are 17 rich elements in total — code blocks, charts, terminal simulations, stat counters, cards, quotes, callouts.

Embed anywhere

Every deck exports as a self-contained .cup file (a small zip with manifest, content, theme, and resources). One web component lets you embed it on any site:

<cuppa-cue src="/presentations/building-ai-agents/" autoplay></cuppa-cue>

That’s how the demos on this site work — each card on the homepage is a real cuppa.studio deck, rendered live.

What we believe

Writing a presentation is the process of clarifying your thinking. You can’t fake your way through an explanation: structure exposes gaps, sequence exposes leaps of logic, narration exposes the parts you only half-understand. A tool that makes presentations easier to build — not just prettier — makes engineers think more clearly.

That’s the bet. Right on cue.

Open cuppa.studio →