---
name: add-showcase-app
description: Add one or more apps to the OpenIAP "Apps built with OpenIAP" showcase — record OpenIAP library and IAPKit usage, normalize icons, refresh ordering metrics, and verify the docs build. Use when someone submits apps through discussion #350, a showcase pull request, X, or email, or when the user asks to add or update apps on openiap.dev/showcase.
---

# Add Showcase App (Claude Code)

The canonical procedure lives in `.codex/skills/add-showcase-app/SKILL.md`.
Read it and follow every section — collecting the submission, choosing an icon,
appending the JSON entry, refreshing metrics, verifying, and closing the loop
are agent-agnostic and apply as written.

## Claude Code Notes

- Fetch submissions with the GitHub MCP tools or `gh` instead of asking the user
  to paste them. The live thread is discussion #350, which the issues endpoint
  cannot read:

  ```bash
  gh api graphql -f query='
  query { repository(owner: "hyodotdev", name: "openiap") {
    discussion(number: 350) { comments(first: 50) { nodes { author { login } body } } } } }'
  ```

  Issue #280 is the closed predecessor; read it only for history.

- To verify rendering, start the docs dev server through `preview_start`
  (`.claude/launch.json` defines the `docs` configuration) and check the
  showcase section in the browser pane. The home page section sits far down the
  page — scroll to the `Apps built with OpenIAP` label, or open `/showcase`
  directly, which renders the full list near the top.
- If browser screenshots come back blank, fall back to headless Chrome against
  the dev server and crop the region with Pillow.
- Attach the rendered section back to the user with `SendUserFile` so they can
  approve the card before anything is committed.