How To: Build Automated Web Narratives

Master the art of combining slides-tape's demos with live audio for the ultimate technical demo.

One of the most powerful patterns in slides-tape is the Web Narrative. This allows you to walk your audience through slides which could be a demo of a complex web UI while you narrate, with the engine handling the clicks and typing perfectly.

Step 1: Define your automation block

In your Markdown file, use a web run block. Unlike standard code blocks, these are executable instructions.

# My Demo

```web run
# @goto https://my-app.com
# @type input[name="q"] "slides-tape"
# @press Enter
# @waitUntilIdle
```

Step 2: Add your transition markers

The @waitUntilIdle tag is critical. It ensures that slides-tape doesn’t rush through the demo while you’re still speaking.

Step 3: Record live

When you run slides-tape serve, use the Live Recorder (the microphone icon). As you click through your slides, your voice is captured and mapped 1-to-1 with these automation events.

Pro-Tip: Use Semantic Locators

Instead of XPath, use @clickText "Login". It makes your Markdown readable and resilient to small UI changes.

Ready to ship? Just run:

slides-tape export my-demo.md

Your automated clicks and your live voice will be merged into a single high-fidelity MP4.