Support Widget

The FuzzyFlags support widget is a single script you add to a signed-in page. It loads a small launcher fixed to the bottom-right corner of the viewport. When a user clicks the launcher, a panel opens where they can send feedback, a request, a bug report, or something they cannot categorize.

What the script does

1. Loads https://support-widget.onfzf.app/app.js and automatically fetches its stylesheet.
2. Renders a circular button at the bottom-right of the page with the highest available stacking context so it stays above most UI elements.
3. Opens a compact form when the user clicks the button. The form asks for a request type, a description, and an optional email or identifier.
4. Sends the submission to the support service API, which validates the widget API key and origin, applies per-IP rate limiting, and checks the request shape.
5. Uses Moonshot AI to rewrite the raw description into a clear Linear issue title and description.
6. Creates a Linear issue in the team you configured when mounting the widget.
7. If the Linear team already has a label named feedback, request, bug, or can't tell, the matching label is applied to the issue.
8. Appends browser context to the issue: the current page path, page title, sanitized page URL and referrer, viewport size, locale, timezone, user agent, and submission timestamp. Query strings and fragments are stripped from URLs before they leave the browser so tokens and other sensitive parameters are not transmitted.

Lifecycle

The widget is meant to be mounted only when your application knows the user is signed in. Call FzfSupport.destroy() when they sign out so the previous user’s identity is not left in the form. The same global API also exposes show(), hide(), and identify(user) for single-page applications that need to react to navigation or authentication changes.

For setup instructions and code examples, see the Installation guide.