Quickstart

This walks you from an empty dashboard to your first feedback report — and then exports that report as agent-ready Markdown you can hand to an AI coding tool.

1. Create a project.

   Open the dashboard at room.patchrooms.com and create a project. Each project is a separate stream of feedback with its own key, channels, and reports.

2. Copy your project key.

   Open your project’s Settings tab. The Project key starts with pr_ (for example pr_abc123…). It’s public — safe to ship in a browser bundle. Copy it.

   Note

   The pr_ project key is the public key the widget uses. It is not the same as a pr_sk_ secret key, which lives in the Integrations tab and is only for read-only MCP access. See Get your project key.

3. Paste the loader into your app.

   Add this one line to your page’s HTML, swapping in your own key. Put it before the closing </body> tag.

   <script src="https://room.patchrooms.com/v1/patchrooms/pr_xxx.js"></script>

   This loader bakes your project’s widget config and channels into the script on the server, so the widget appears with the right theme immediately — no extra round-trip, no flash. It auto-initializes; you don’t call any function.

   Tip

   Prefer to wire it up in code (for an SPA, or to pass userId/extra)? Use the programmatic init instead:

   <script src="https://room.patchrooms.com/v1/patchrooms.js"></script>
   <script>Patchrooms.init({ projectKey: 'pr_xxx' });</script>

   Both forms are valid. See Install the widget for the full option list.

4. Load your app — the widget appears.

   Reload the page. The Patchrooms launcher docks itself to the edge of the viewport.

5. Open it and leave a comment.

   Click the launcher to open the room. It’s a thread, not a single form — you can stack multiple blocks into one report:

   • Text — type a note.
   • Screenshot — capture the page.
   • Audio — record a voice note.
   • Selection — quote text from the page, anchored to where it came from.

   Add a text block, then submit.

6. See it in the dashboard.

   Switch back to room.patchrooms.com, open your project’s Feedback tab, and your report is there — new reports stream in live. Each report shows its blocks, its channel, and the page context it was filed from.

7. Export agent-ready Markdown.

   On the Feedback tab, click Export ZIP. You get a feedback.zip containing a feedback.md (wrapped so an AI agent can act on it) plus any screenshots under screenshots/. You can scope the export by status or channel before downloading. Hand the Markdown to your coding agent and let it work the feedback.

What’s next

• Install the widget — every install option and data-* attribute.
• Your first feedback room — what each block type does and where reports land.
• Get your project key — public pr_ key vs. pr_sk_ MCP secret.