IFInstaFeedOPEN SOURCE
A LITTLE BUTTON. A LOT MORE CONTEXT.

Feedback, right
where it happens.

Add InstaFeed to your web app. Testers choose a thumbs up or down, the page is captured, and a quick comment fills in the rest.

Add it to your app
MIT licensedWorks with any web appNo tester account needed
THE PAGE + THE CONTEXT
your-app.com / workspace
n•S
Workspace⌕
YOUR WORKSPACEA little progress, every day.Here’s what your team is working on.
↗
Website refreshDesign · 4 tasks left
◈
Product onboardingIn progress · 2 tasks left
Last edited just nowSave changes
EXAMPLE FEEDBACK✓ Screenshot attached

“The save button is a little hard to find.”

your-app.com / workspaceJust now
The screenshot tells you where. The comment tells you why.
You’re already in the demo.Hover over the purple button to choose a thumb. On touch screens, tap it first. Your screenshot and optional note go to our demo inbox.
LESS BACK-AND-FORTH

From “something feels off”
to something you can act on.

Give testers a simple way to show you what they mean, without leaving the page.

  1. 01

    A tap captures the moment.

    The floating button splits into thumbs up and down on hover or tap. Pick a reaction to capture the page and save it with the URL.

  2. 02

    A comment adds the context.

    Your selected thumb becomes a compact “Add a comment?” field. Testers can expand it and attach a note to the same report.

  3. 03

    Your team gets the full picture.

    Review positive and negative feedback in a protected inbox, with screenshots, comments, page titles, and browser details together.

A FEW LINES TO GET STARTED

Your app. One little addition.

Read the documentation ↗
01 / INSTALL THE SDK

Bring InstaFeed into your app.

Install from GitHub. The package and import name are feedback-fab.

TERMINAL
npm install github:sshadmand/feedback-fab
02 / ADD THE WIDGET

Initialize after your page loads.

Point it at your feedback API and give your app a name. It works with plain JavaScript or your favorite framework.

For React, create it in an effect and call widget.destroy() during cleanup.

JAVASCRIPT / TYPESCRIPT
import { createFeedbackFab } from 'feedback-fab';

const widget = createFeedbackFab({
  endpoint: 'https://your-feedback-api.vercel.app',
  appName: 'My app',
});
03 / CONNECT YOUR FEEDBACK INBOX

Host the API. Keep the feedback yours.

Import the repository into Vercel, connect Neon Postgres, and set DATABASE_URL and FEEDBACK_REVIEW_TOKEN. Use your deployment URL as the SDK endpoint. The included review inbox opens at /review.html with your review token.

Set FEEDBACK_ALLOWED_ORIGINS to limit submissions to your app’s domains.

Deploy guide ↗

Made to fit into your app.

The widget isolates its styles with Shadow DOM. Choose a specific element to capture, handle submission callbacks, or remove the widget when a component unmounts.

Know what gets captured.

Reports include the screenshot, page URL, title, and browser details. Cross-origin iframes and protected media may not appear. Use it on pages your testers are comfortable sharing.

LESS EXPLAINING. MORE UNDERSTANDING.

Put feedback where your users are.

Get started