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-repo="owner/repo"
  data-api-url="https://feedback.one-dot.io"
  data-position="bottom-right"
  defer
></script>

Attributes

data-repo (required) — GitHub repository in owner/repo format. Issues are created here.
data-api-url — Base URL of the deployed API. Defaults to the current origin. Point this at your own Vercel deployment.
data-position — Button placement: bottom-right (default) or bottom-left.

When does the widget load?

The script tag is safe to include in production — the widget UI will only activate under specific conditions. 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 main widget bundle is never downloaded, no widget is rendered, no API requests are made, and no DOM changes occur. This means you can ship the same build to production and staging — the widget only appears where you want it.