rhdh-playwright

Files (2)

• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

# Play RHDH

Automate RHDH UI navigation and verification using `playwright-cli` (NOT the Playwright MCP).

## Quick Start

Run `command -v playwright-cli` before opening the browser. If it is missing,
stop and report that the local `playwright-cli` prerequisite is unavailable.

```bash
# Always use --browser chromium
playwright-cli open <RHDH_URL> --browser chromium
```

The URL is never hardcoded — the user provides it (or it comes from context like CLAUDE.md).

## Authentication — Guest Login

After opening a RHDH instance, check whether a login page appeared. If the page title contains "Sign In" or "Log in", or the snapshot shows sign-in buttons, log in as guest:

```bash
# Take a snapshot to check for login
playwright-cli snapshot

# If a login page is detected, look for a guest sign-in option:
#   - Button or link matching: "Enter" (on guest sign-in provider card)
#   - Or a "Guest" / "Sign in as Guest" button
# Click it:
playwright-cli click "<ref>"      # ref of the guest sign-in button
```

RHDH login pages typically show provider cards. The guest provider shows a title like "Guest" with an "Enter" button. Click the "Enter" button on the guest card.

After login, verify navigation succeeded by checking that the sidebar appeared:

```bash
playwright-cli snapshot --depth 3
# Confirm: navigation "sidebar nav" is present
```

## Sidebar Navigation

The sidebar uses `navigation "sidebar nav"` containing links. Navigate by clicking the link with the target label.

| Destination | Selector pattern |
|---|---|
| Home | `link "Home"` |
| Catalog | `link "Catalog"` |
| APIs | `link "APIs"` |
| Docs | `link "Docs"` |
| Create | `link "Create"` |
| Explore | `link "Explore"` |
| Settings | `link "Settings"` |
| Notifications | `link "Notifications"` |
| Search | `button "Search"` |

Additional sidebar items (plugins) appear below a separator. Their labels match their menu name (e.g., `link "Tech Radar"`).

```bash
# Navigate to a sidebar item
playwright-cli click "getByRole('navigation', { name: 'sidebar nav' }).getByRole('link', { name: 'Catalog' })"
```

## Catalog Page

After navigating to the catalog, the page shows filters and a table of entities.

### Filters

| Filter | Element type | Locator |
|---|---|---|
| Kind | button (shows current value) | `button "Component"` (or current kind) |
| Type | button | `button "all"` (or current type) |
| Owner | combobox + textbox | `textbox "Owner"` |
| Lifecycle | combobox + textbox | `textbox "Lifecycle"` |
| Tags | combobox + textbox | `textbox "Tags"` |

To filter by Kind, click the Kind button and select from the dropdown:

```bash
playwright-cli click "getByRole('button', { name: 'Component' })"
playwright-cli snapshot   # find the desired kind option
playwright-cli click "<ref>"  # click the desired kind
```

### Search the Catalog

```bash
playwright-cli fill "getByRole('textbox', { name: 'Search' })" "my-entity"
```

### Catalog Table

The entity table has columns: Name, System, Owner, Type, Lifecycle, Description, Tags, Actions.

Entity names in the table are links. Their URL pattern is: `/catalog/{namespace}/{kind}/{name}`

```bash
# Click an entity by name
playwright-cli click "getByRole('link', { name: 'artist-lookup' })"
```

### Personal vs All

The catalog has a menu toggle between "Personal" (Owned / Starred) and "RHDH" (All):

```bash
# Switch to "All" entities
playwright-cli click "getByRole('menuitem', { name: /All/ })"
```

## Entity Page

An entity page has:
1. **Header** — shows kind, type, entity name, and metadata (Owner, Lifecycle)
2. **Tabs** — `tablist "Tabs"` containing `tab` elements
3. **Content area** — `article` below the tabs

### Verify an Entity Exists

From redhat-developer/rhdh-skills, Apache-2.0.

More from redhat-developer/rhdh-skills