Report widget

Embed a one-line snippet in your own app and reports land as issues.

The report widget is a tiny toolbar you embed in your own app. Anyone you authorize can file a report from the live page — it lands in your Alkahest project as an issue, with the reporting URL and user agent attached.

Embed

<script
  src="https://unpkg.com/@cr8rcho/alkahest-toolbar/dist/toolbar.global.js"
  data-alkahest-project="your-project-slug"
  defer
></script>

That's the whole integration. The script renders nothing for ordinary visitors — the toolbar only appears for people who have activated it (below), so it's safe to ship to production.

Authorize reporters

Reporting uses scoped tokens — a widget token can file reports and nothing else (it can't read your maps, publish, or touch other projects).

  1. A teammate opens your app with ?alkahest=on appended to the URL.
  2. The toolbar appears and walks them through a one-time consent on alkahest.app (they need an Alkahest account with access to the project).
  3. From then on the toolbar is available for them on that browser.

Where reports go

Each report becomes an issue with:

  • the title/description they typed,
  • the page URL it was reported from,
  • the browser user agent.

Triage them like any issue — on the issue map, the project's Issues page, or let your agent pull them over MCP and investigate. Reports show up in the activity journal with a widget actor chip.

Configuration

AttributeMeaning
data-alkahest-projectProject slug (required — its presence triggers auto-init).
data-issue-mapIssue-map slug to file into (omit to use the project's sole map).

Prefer manual init? The script exposes window.Alkahest.init(config) — drop the data-alkahest-project attribute so auto-init stays out of the way.