Workshop details
Timing and schedule
| Module | Topic | Duration | Required? |
|---|---|---|---|
Module 1 |
Showroom in action |
5 minutes |
Yes |
Module 2 |
Create and configure your Showroom |
10 minutes |
Yes |
Module 3 |
Generate lab content and publish |
15 minutes |
Yes |
Module 4 |
Create a presenter-led demo |
15 minutes |
Optional |
Total |
30-45 minutes |
Modules 1-3 cover the lab path. Module 4 is optional and teaches you how to create presenter-led demo content using /showroom:create-demo.
What you need on your laptop
This workshop runs entirely on your local machine. Make sure you have:
-
GitHub CLI (
gh) — Install instructions -
Git — Install instructions
-
Podman — Install instructions
-
Claude Code — Install instructions
-
A terminal — Terminal.app, iTerm2, Windows Terminal, or your IDE’s integrated terminal
-
A browser — to read these instructions and preview your Showroom
Troubleshooting
Problem: gh auth status shows you are not authenticated
Solution: Run gh auth login and follow the prompts. Select HTTPS and authenticate with your browser.
Problem: GitHub Pages shows a 404 after pushing
Solution: GitHub Pages deployments take 1-2 minutes. Check the Actions tab in your repository to monitor the build status.
Problem: Podman preview shows a blank page
Solution: Ensure you are running the command from the repository root directory where site.yml is located.