Write a storyboard
Start a film by exploring the app, from its code, by showing it once, or from a blank page.
There are four ways to start a film's storyboard. Nobody has to show the feature first unless you want to.
| Start | What happens |
|---|---|
| Explore the app and write it | Showreel Studio walks the app by itself, reads its screens and writes the script, with the steps to record each line. |
| Write it from the code | The script is written from the app's code: its docs, source and pull requests. |
| Show it once | You click through the feature in a browser; every screen becomes a line with its steps. |
| Start blank | Two empty lines to write yourself. |
Before you start
- The app connected: Connect your app. Only Start blank works without one.
- To write from the code, the folder with the app's code: Give the writers your app's code.
In the app
- Open Films and click New film.
- Give it a Title. The Folder name follows the title until you change it.
- Choose The app it films.
- Under What should it show?, say the feature, who it is for and the moment it lands, in a sentence or two. The writer needs this for the first two starts.
- Choose How should it start?
- For Explore the app and write it, you can also give The app's code, to be read alongside the walk. For Write it from the code, it is needed.
- Click Create the film. Nothing is made until you do; Cancel or Esc closes the dialog with nothing made.
The film opens when the script is ready. Show it once opens a Chrome window instead: see Record a demonstration.
To rewrite an existing film's script, open its Film panel and use the Write the script card. Tick what to read (the app, explored, its code, or both), fill in Feature, and optionally a Pull request and Anything to tell the writer. Click Write the script.
In the terminal
Make the film's folder:
showreel new compose --title "Compose"Write the lines from a walk of the app:
showreel storyboard compose --feature "Compose" --exploreOr from the code, with a pull request and a brief:
showreel storyboard compose --feature "Compose" --repo ~/code/my-app --pr 42 --brief "For new users; the payoff is the finished draft"--title keeps a title you chose. In a Claude Code session, the command hands the writing to Claude there; see Who writes your scripts.
Read it before you approve it
The writer only claims what the app or the code told it. A wrong label or a wrong count is the first thing to look for. Then check the steps with Snapshot the screens.