BugDrop icon

BugDrop

BugDrop is an open-source website feedback widget that creates GitHub Issues from user reports. It helps teams capture screenshots, annotations, browser metadata, and privacy-masked feedback through a single script tag.

BugDrop

Overview

BugDrop is an open-source website feedback widget that sends user reports into GitHub Issues. It is designed for teams that want feedback, bug reports, and visual context to land in the same repository they already use for development work.

The product combines a floating feedback button, screenshot capture, annotations, and browser metadata with a setup flow that uses the GitHub App plus a single script tag. The installation docs say it requires no npm package, build configuration, or backend setup, and the widget can be customized with data attributes and privacy masking options.

Core features

GitHub issue creation

Turn user feedback into GitHub Issues with the reporter’s description, category, page URL, browser details, viewport size, operating system, and optional screenshot or annotation attached to the issue.

Screenshot capture and annotations

Let users capture a screenshot and mark up the problem before submitting, so developers receive visual context instead of a text-only description.

Privacy controls for screenshots

Redact sensitive areas before submission and mask designated elements with `data-bugdrop-mask`; passwords and credit-card fields are protected automatically.

Lightweight installation

Install with the GitHub App and one script tag, with no npm package, build step, or backend setup required.

Widget configuration

Customize widget appearance and behavior with script attributes such as theme, position, color, and welcome text.

Broad site support

Add the widget to production sites, docs sites, internal tools, staging environments, and framework-based apps such as Next.js, Vue, Nuxt, Svelte, and SvelteKit.

Common use cases

  • GitHub-native bug triage

    Teams can collect bug reports from users without sending them to a separate dashboard. Reports arrive in GitHub with enough context for engineering to triage, assign, and close issues in the same place they already work.

  • Visual bug reporting

    Reporters can capture the exact broken state of a page with screenshots and annotations, which is useful when the problem is a layout overlap, clipped content, rendering issue, or other visual regression.

  • Privacy-aware feedback collection

    Sites with customer data or private UI can still use visual feedback by relying on manual redaction and developer-marked masked elements before submission.

  • Cross-site deployment

    The widget can be added to docs, marketing sites, internal tools, staging sites, and framework apps, making it suitable when different products need the same feedback flow.

  • Staging and QA review

    Teams testing on production or staging can verify that the widget appears, collects feedback, and creates an issue in the target repository before rolling the setup out more broadly.

Pros and Cons

Pros

  • Creates GitHub Issues directly, so teams can keep feedback in their existing triage workflow.
  • Captures screenshots, annotations, and browser metadata to make reports more actionable.
  • Uses a single script tag and GitHub App installation, with no npm package or backend required.
  • Supports privacy masking for sensitive page content and lets developers mark elements to hide in screenshots.
  • Can be self-hosted according to the landing page copy and site footer references.

Cons

  • Screenshots are stored in a dedicated repository branch, so teams using branch protection or CI rules need to account for `bugdrop-screenshots`.
  • The public pricing page shown in the source currently returns a 404, so pricing details are not available from the provided evidence.
  • The source does not document a full API surface or every available configuration option.

FAQ

How do I install BugDrop?

BugDrop is installed by adding the GitHub App to the repository you want to receive issues and then placing a single script tag on your site. The script must load synchronously, and the widget can be added to plain HTML or framework layouts.

What does a BugDrop report include?

The source shows BugDrop creating formatted GitHub Issues that include the reporter’s description, labels, page URL, browser details, viewport size, operating system, and optional screenshots or annotations.

What GitHub permissions does BugDrop need?

Yes. The installation docs say the app requests read and write access to Issues to create reports and read and write access to Contents to store screenshots. The docs also say it does not request access to code, pull requests, actions, or other repository data.

How does BugDrop handle sensitive information in screenshots?

BugDrop supports manual redaction before submit and developer-configured masking with the `data-bugdrop-mask` attribute. Password inputs and credit-card autocomplete fields are masked automatically.

Where are screenshots stored?

The docs say screenshots are stored in a dedicated `bugdrop-screenshots` branch in the repository, and branch protection may need to allow the GitHub App to push to that branch.

Quick Facts

Category
Developer tool
Primary workflow
Website feedback to GitHub Issues
Install
GitHub App plus one script tag
Open source
MIT licensed
Host / platform
Cloudflare Workers
Source site
bugdrop.dev