Getting started with Red Hat Showroom

Welcome to the Getting started with Red Hat Showroom workshop!

A different kind of Showroom

This workshop is designed to run on your local laptop. You will read these instructions in your browser and run commands in your own terminal — there is no embedded terminal on the right side of the screen.

Why? Because creating Showroom content is local work: you clone repos, edit files, run Claude Code, and push to GitHub. This lab meets you where that work happens.

When Showroom labs are deployed on the Red Hat Demo Platform, learners get an embedded terminal and execute blocks that send commands directly to it. This lab uses the simpler GitHub Pages delivery model instead, which is the fastest way to publish and share a Showroom.

What you’ll learn

In this workshop, you will:

  • Understand how Red Hat Showroom works and the two types of content it supports (labs and demos)

  • Create your own Showroom repository from the official template

  • Configure the site, UI, and navigation

  • Generate a hands-on lab module using /showroom:create-lab

  • Optionally, generate a presenter-led demo module using /showroom:create-demo

  • Publish your Showroom to GitHub Pages

Two paths

Showroom supports two types of content:

  • Labs — self-paced, hands-on exercises where learners follow step-by-step instructions (Modules 1-3, required)

  • Demos — presenter-led walkthroughs with Know/Show structure and timing cues (Module 4, optional)

You will build a lab first. If you also want to learn how to create demo content, continue to the optional Module 4.

Who this is for

This workshop is for Red Hat associates — solution architects, technical marketing managers, product managers, developer advocates, and anyone who needs to create workshops or demos for Red Hat products.

Experience level: Beginner — no prior AsciiDoc, Antora, or Showroom experience required.

Prerequisites

Before starting, you need:

  • A Red Hat GitHub account with access to the rhpds organization

  • GitHub CLI (gh) installed

  • Podman installed (for local preview)

  • Claude Code installed with the RHDP Skills Marketplace plugin

  • A terminal application (Terminal.app, iTerm2, Windows Terminal, etc.)

Estimated time

  • Lab path only (Modules 1-3): approximately 30 minutes

  • Lab + demo (Modules 1-4): approximately 45 minutes

Let’s get started!

Open a terminal on your laptop and click Workshop overview in the navigation to begin.