Design Mode
Designers & PMs

Bug reports with a visual diff

PMs and designers file most of the visual bugs. Engineering has to translate ambiguous descriptions into code changes. Design Mode bridges the two — annotate the bug visually, export a developer-ready diff.

The problem

"The button is wrong" is not actionable. "The button's `padding-block` should change from 8px to 12px and the `background-color` from #3B82F6 to #4F46E5" is. The latter takes 30 seconds in Design Mode.

The workflow

  1. Step 1

    Open the affected page

    Browse to the page where the bug appears. Open the Design Mode side panel.

  2. Step 2

    Fix it visually

    Make the change you'd want shipped. Use the contrast checker, the spacing inspector, the type controls.

  3. Step 3

    Export markdown diff

    Click Export → Markdown. The result lists every property change with selectors.

  4. Step 4

    Paste into your tracker

    Linear, GitHub, Jira, Asana — all accept the markdown. Attach the before/after screenshots from Design Mode.

The outcome

Developers stop arguing about what the bug actually is and just fix it.

Related use cases