Framebolt

Updated August 17, 2026

Write clearer UI bug reports with one precise screenshot

A useful bug screenshot gives the reader context, target, and expected outcome without leaking unrelated data. Framebolt keeps the raw image local while making an annotated export easy.

Check release status
Illustrative bug-report cardIllustrative UI
Issue #184 · synthetic
target
The issue number, UI card, and annotation are synthetic and intentionally labeled as illustrative.

The four-part report

  1. 1

    State the observed result

    Write what happened in one sentence, including the visible state and the action that led there.

  2. 2

    Capture the target

    Select only the relevant region or display. Include enough surrounding UI to identify where the problem lives.

  3. 3

    Mark the mismatch

    Add one arrow, box, or short label. Keep the annotation outside the control when possible so the original pixels remain legible.

  4. 4

    Describe expected behavior

    Say what should have happened and include a build, route, or reproduction detail when it changes the interpretation.

Privacy checklist before paste

  • Redact tokens, email addresses, customer data, and private URLs.
  • Check browser tabs, notifications, terminal history, and background windows.
  • Prefer a region capture over the whole display when the surrounding desktop is irrelevant.
  • Keep the raw local PNG untouched; export a marked copy when the destination needs the annotation.

Destination-neutral sharing

These are paste destinations, not Framebolt integrations.

DestinationUseful payloadFollow-up
GitHub issue or PRAnnotated PNG + reproduction stepsLink the affected commit or route
LinearFocused image + expected resultAdd environment and build details
SlackSmall image + one-sentence contextMove durable details into the issue

Questions about screenshots for bug reports and ui feedback