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:

  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.