# Usero

> Feedback becomes code. Automatically.

Usero is a lightweight feedback widget and dashboard that turns user feedback into GitHub pull requests. Users report bugs, request features, or flag UX issues. AI clusters the signal. Claude reads your codebase and opens a PR with the fix.

## Key Facts

- Widget: 7.6KB (MIT open source)
- Stack: React widget + Cloudflare Workers + D1 + Prisma
- AI: Claude Code SDK analyzes your codebase and writes actual code fixes as PRs
- Success rate: 96% on targeted bugs (typos, broken links, UI glitches)

## How It Works

1. Add the widget to your app (`npm install @usero/sdk`, works with React or vanilla JS)
2. Users submit feedback with emoji ratings and optional comments
3. Feedback appears in your dashboard with analytics and AI-powered clustering
4. Click "Generate PR", Claude reads your codebase and opens a GitHub PR with the fix
5. Review, merge, deploy

## Widget Installation

```bash
npm install @usero/sdk
```

React:

```tsx
import { UseroFeedbackWidget } from "@usero/sdk/react";

<UseroFeedbackWidget clientId="your-client-id" />
```

Vanilla JS (Vue, Svelte, Angular, Electron, plain HTML):

```ts
import { initUseroFeedbackWidget } from "@usero/sdk";

initUseroFeedbackWidget({ clientId: "your-client-id" });
```

CDN script tag:

```html
<script src="https://unpkg.com/@usero/sdk"></script>
<script>Usero.initUseroFeedbackWidget({ clientId: "your-client-id" })</script>
```

### Widget Props

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| clientId | string | Required | Your unique client identifier from usero.io |
| position | 'right' \| 'left' | 'right' | Position of the feedback button |
| title | string | 'Share Your Feedback' | Header title for the feedback form |
| placeholder | string | 'Tell us what you think...' | Placeholder text for the comment field |
| environment | string | undefined | Environment tag (e.g., 'prod', 'staging') |
| metadata | Record<string, unknown> | undefined | Arbitrary key-value data attached to each submission |

## Pricing

| Tier | Price | PRs/month | Feedback items/month |
|------|-------|-----------|---------------------|
| Starter | Free | 5 | 1,000 |
| Pro | $19/mo | 50 | 10,000 |
| Team | $89/mo | 200 | 50,000 |

## Links

- Website: https://usero.io
- Developer docs: https://usero.io/docs
- Pricing: https://usero.io/pricing
- Widget comparison: https://usero.io/compare
- npm package: https://www.npmjs.com/package/@usero/sdk
- Open source widget: https://github.com/usero-feedback/usero
- Contact: https://usero.io/contact

## Differentiators

- 30x smaller than Hotjar (7.6KB vs 230KB)
- Writes code, not just tickets, PR ready to merge
- Real free tier with actual utility, not a trial
- Pricing doesn't assume VC funding ($19/mo vs $49/mo+ competitors)

## Docs

Developer documentation. Every page is also served as raw markdown at the linked .md URL. All pages concatenated: https://usero.io/llms-full.txt

- [Quickstart](https://usero.io/docs/index.md): Send your first feedback to Usero in 5 minutes with one POST. No SDK, no API key. curl, JavaScript, Swift, and Python examples.
- [API reference: POST /api/feedback](https://usero.io/docs/api/feedback.md): Full reference for the Usero feedback API: every request field, required logic, response shape, and error codes.
- [API reference: screenshot uploads](https://usero.io/docs/api/screenshots.md): Upload screenshots to Usero with a multipart POST, then attach them to feedback submissions.
- [Feedback widget (@usero/sdk)](https://usero.io/docs/widget.md): Install the Usero feedback widget with React, vanilla JS, or a script tag. Options table, theming, and user identification.
- [Session replay plugin](https://usero.io/docs/widget/session-replay.md): Attach a rolling session recording to each feedback submission with the @usero/sdk session replay plugin. Privacy defaults and sampling.
- [Find your clientId](https://usero.io/docs/find-your-client-id.md): Where your Usero clientId lives in the dashboard and how to verify it from the command line.
- [Integrations](https://usero.io/docs/integrations.md): Every way feedback gets into Usero besides the widget and the API: GitHub, Slack, email, WordPress, Chrome extension, Intercom, and Forms.

## Blog

Long-form guides on user feedback, product, and building user obsessed teams.

- [How to Add a Feedback Widget to a React App (Build vs Buy)](https://usero.io/blog/embed-feedback-widget-react): A practical guide to adding a feedback widget to a React app: the moving parts, the SSR and CSS gotchas, build-it-yourself vs a 3-line drop-in.
- [Customer Feedback Software for Startups: 6 Honest Picks for 2026](https://usero.io/blog/customer-feedback-software-for-startups): Customer feedback software for startups, compared honestly. Real free tiers, flat pricing, and which tool fits which budget.
- [User Feedback Collection: 8 Best Practices That Actually Move the Needle](https://usero.io/blog/user-feedback-collection-best-practices): Eight user feedback collection best practices for SaaS teams: when to ask, which channel wins, real response-rate numbers, and how to act on it.
- [How to Close the Customer Feedback Loop (Without It Going Nowhere)](https://usero.io/blog/close-the-feedback-loop): Closing the feedback loop means telling users what you shipped. Here is the four-step system, real response-rate numbers, and where it breaks.
- [Do AI Models Recommend the Same Feedback Tool? I Ran 577 Tests](https://usero.io/blog/do-ai-models-recommend-the-same-feedback-tool): I asked GPT-5.5, Gemini, and Claude the same product-recommendation questions 577 times. The models could not agree with themselves, and the cited-domain map shows how to actually get recommended by AI.
- [An AI rebranded my startup in half an hour. I'm probably not doing it. Would you?](https://usero.io/blog/i-let-an-ai-rebrand-my-startup): I gave an AI one sentence about my startup and asked it to rebrand it from scratch. It came back with a name, a voice, and a logo set I actually like, then got the trademark and the facts about my business confidently wrong. Vote: keep Usero, or rebrand to Lumen?
- [Productboard vs Usero: Honest Head-to-Head (2026)](https://usero.io/blog/productboard-vs-usero): Productboard vs Usero compared honestly. Productboard organizes what your users want, Usero ships it. Per-maker pricing vs flat workspace pricing, a 6-person cost table, and when each one wins.
- [How to Collect User Feedback In-App: 7 Methods Compared](https://usero.io/blog/how-to-collect-user-feedback-in-app): How to collect user feedback in-app: 7 methods compared (widget, microsurveys, session replay, voting, chat) with response rates and what to ship first.
- [NPS vs CSAT vs CES: Which One to Track](https://usero.io/blog/nps-vs-csat-vs-ces): NPS vs CSAT vs CES explained: what each metric measures, the exact survey questions, benchmarks, and which one a startup should actually track.
- [AI-Generated PRs From User Feedback: How It Works](https://usero.io/blog/ai-generated-prs-from-user-feedback): How AI-generated PRs from user feedback work: collect, cluster, draft a GitHub pull request, then a human reviews and merges. Honest about the limits.
- [Feature Request Management: A Complete Framework](https://usero.io/blog/feature-request-management-framework): A repeatable 5-stage framework for feature request management: capture, cluster, prioritize with RICE, decide, and close the loop.
- [GitHub Issues as a Feedback Tool: When It Works, When It Breaks](https://usero.io/blog/github-issues-as-feedback-tool): Honest take on using GitHub Issues as a feedback tool: where it works, where it breaks, and when to route a feedback widget into GitHub instead.
- [How to Collect User Feedback in a Next.js App (in 5 Minutes)](https://usero.io/blog/collect-user-feedback-nextjs): Add a feedback widget to a Next.js App Router app in ~5 minutes: install, mount in app/layout.tsx, identify the user. Copy-paste code to collect user feedback.
- [AI That Fixes User-Reported Bugs (How It Works)](https://usero.io/blog/ai-that-fixes-user-reported-bugs): Usero connects user-reported bugs to AI that drafts the fix: it clusters reports, reads your GitHub repo, and opens a draft pull request with a working first pass. You review and merge. Free to start, paid from $19/mo.
- [How to Turn User Feedback Into Shipped Code](https://usero.io/blog/turn-user-feedback-into-shipped-code): Turning user feedback into shipped code is a four-step chain: collect, cluster, prioritize, and write the change. Here is how to run it, and the one tool that automates the whole thing into a draft GitHub PR.
- [The Feedback Tool That Opens a GitHub PR for You](https://usero.io/blog/feedback-tool-that-opens-a-pr): Usero is the feedback tool that opens a GitHub pull request for you. It collects user feedback, clusters it with AI, and drafts a draft PR against your repo with a first pass at the fix. Free to start, paid from $19/mo.
- [The Loud 1% Are Not Your Users.](https://usero.io/blog/stop-building-a-feedback-portal): Most users never post on your feedback portal. Here's where the real signal hides, and why hunting for it beats waiting on a feature request board.
- [Canny Alternatives for Indie Hackers (2026)](https://usero.io/blog/canny-alternatives-for-indie-hackers): Honest Canny alternatives for indie hackers: Featurebase, Frill, Nolt, Productboard, Beamer, and Usero. Real pricing, real trade-offs, no listicle filler.
- [What Is a Feedback Widget? (And How to Pick One)](https://usero.io/blog/what-is-a-feedback-widget): A feedback widget is a small UI element embedded in a website or app that lets users send feedback without leaving the page. Here is how they work, what to look for, and the four worth your time in 2026.
- [What Is Session Replay? (And When You Actually Need It)](https://usero.io/blog/what-is-session-replay): Session replay reconstructs what a user did in your app from DOM snapshots and events, not video. Here is how it works, the privacy traps, when it earns its keep, and the five vendors worth your time.
- [Productboard Alternatives for Small Teams (2026)](https://usero.io/blog/productboard-alternatives-small-teams): Honest Productboard alternatives for teams under ten people: Usero, Featurebase, Frill, Canny, Linear, ProductPlan, and DIY. Real pricing, real trade-offs, no listicle filler.
- [Product Roadmap Prioritization Frameworks That Actually Work](https://usero.io/blog/product-roadmap-prioritization-frameworks): RICE, MoSCoW, ICE, Kano, value vs effort, WSJF. Real critique of each, when to use which, and a worked example scoring the same feature across all of them.
- [Why Companies Ignore Customer Feedback (And How to Stop)](https://usero.io/blog/why-companies-ignore-customer-feedback): Companies do not ignore feedback because they are lazy. They ignore it because of structural reasons that compound. Here is what is really going on.
- [How to Organize Feature Requests Without Drowning](https://usero.io/blog/how-to-organize-feature-requests): A practical five-step system for collecting, deduping, and prioritizing feature requests so they actually drive your roadmap.
- [Best User Feedback Tools (2026 Comparison)](https://usero.io/blog/best-user-feedback-tools): An honest comparison of Canny, Productboard, Frill, Featurebase, Nolt, Beamer, and Usero. Real verdicts, real pricing, what each is good for.
- [User Obsessed Meaning: What It Really Means (And How to Build It)](https://usero.io/blog/user-obsessed-meaning): What does user obsessed mean? Learn the real definition, examples of user obsessed companies, why it matters, and how to build a user obsessed culture.