BugDrop: Open Source Visual Feedback Widget for GitHub Issues

BugDrop is a free, open source visual feedback widget that converts user feedback directly into GitHub Issues.

If you've used tools like BugHerd or Usersnap, BugDrop works similarly - but it's free, open source, and integrates directly with your GitHub workflow. Users click a bug button, capture and annotate screenshots, and submit them as issues in your repository. No more "can you describe what you saw?" back-and-forth.

Try it yourself: Live Demo


How It Works

The website bug reporting flow is simple:

  1. User clicks the bug button on your site
  2. Widget captures a screenshot of the current page
  3. User annotates the screenshot and adds a description
  4. Issue gets created in your GitHub repo with the screenshot attached

The widget runs in a Shadow DOM for style isolation, uses Cloudflare Workers for authentication, and stores screenshots directly in a .bugdrop/ folder in your repository. No third-party data storage.

Features

  • Visual feedback with annotations - users can draw on screenshots before submitting
  • Customizable widget - light/dark/auto themes, configurable positioning
  • Works with public and private repos
  • Privacy-focused - no user data retained by the service
  • Minimal permissions - GitHub App only needs Issues (R/W) and Contents (R/W)

Install the GitHub App

View on GitHub