Skip to content

docs: add widget warm neutral restyle spec + plan#110

Closed
neonwatty wants to merge 2 commits intomainfrom
docs/widget-warm-neutral-restyle-spec
Closed

docs: add widget warm neutral restyle spec + plan#110
neonwatty wants to merge 2 commits intomainfrom
docs/widget-warm-neutral-restyle-spec

Conversation

@neonwatty
Copy link
Copy Markdown
Collaborator

Summary

Adds the design spec and implementation plan for restyling the BugDrop widget on the bugdrop-widget-test venue. Pairs with mean-weasel/bugdrop-widget-test#67 which shipped the actual data-* attribute changes.

What's in this PR

  • docs/superpowers/specs/2026-04-14-widget-warm-neutral-restyle-design.md — design spec walking through the problem (marketplace screenshots showed default-styled widget with near-invisible input borders), the constraints (no bugdrop source changes, test repo only), the token map of exact hex values, and the screenshot reshoot procedure
  • docs/superpowers/plans/2026-04-14-widget-warm-neutral-restyle.md — step-by-step implementation plan covering clone → branch → edit HTML → verify → commit → push → PR → preview check → reshoot → merge

No code changes. Pure documentation to preserve design context for future reshoots and similar restyle work.

Why this lands on main

Following the pattern of other spec/plan docs committed under docs/superpowers/ (e.g. d01604f docs: add design spec for screenshot threshold benchmark). Making the reasoning visible in main means future contributors (and future-me) can see:

  • Why the widget's default border color is effectively invisible against its default background
  • Which data-* attributes are wired up in src/widget/index.ts but not yet in the README
  • The exact procedure for re-shooting marketplace screenshots (peach gradient overlay, host DOM hide, lineWidth monkey-patch for visible Draw strokes)

Test plan

  • Markdown renders cleanly on GitHub
  • Linked implementation PR (bugdrop-widget-test#67) is already merged
  • All file paths referenced in the spec/plan exist

Brainstormed restyle of the BugDrop widget on the bugdrop-widget-test
venue using existing data-* customization API. Goal: polish the
marketplace product screenshots so the widget reads as a shipped
indie SaaS product, not an engineering mockup.

Implementation lands in mean-weasel/bugdrop-widget-test (no bugdrop
source changes needed).
Step-by-step plan for applying the warm-neutral styling to the
bugdrop-widget-test venue and re-shooting marketplace screenshots.
Paired with the design spec added in the previous commit.
@neonwatty neonwatty closed this Apr 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant