OD-Report

Embeddable bug-reporting widget — click any element, annotate, submit to GitHub Issues.

Embed

Add this <script> tag to your HTML, ideally before </body>:

<script
  src="https://feedback.one-dot.io/loader.js"
  data-api-url="https://feedback.one-dot.io"
  defer
></script>

Attributes

data-repo — GitHub repository in owner/repo format. Optional if the API is configured with ALLOWED_ORIGINS or PROJECTS_CONFIG — the repo is then resolved automatically from the request domain.
data-api-url (required) — Base URL of the deployed API. Always set this to https://feedback.one-dot.io (or your own deployment). Without it, the widget sends requests to the embedding page's own origin.
data-always-show — Set to "true" to always load the widget. A lightweight alternative is appending ?bug or ?report to any URL — the widget activates for that page load only.

When does the widget load?

The script tag is safe to include in production. On every page load it checks:

URL contains ?bug or ?report query parameter
Hostname starts with staging. or ends with .dev.one-dot.io

If neither condition is met, loader.js exits immediately — the widget bundle is never downloaded, no DOM changes occur, and no API requests are made. You can ship the same build to production and staging; the widget only appears where you want it.