Getting started

Lightweight, customizable survey widgets to collect user feedback in React apps.

Introduction

react-feedback-surveys is a standalone, open-source (MIT) UI library — no backend, no hosting, no account required. Render the components, wire onScoreSubmit/onFeedbackSubmit to your own backend (or nowhere at all).

Want AI-generated insights, a hosted dashboard, and response storage without building your own backend? Check out feedback.tools — built by the same team.

Features

• Ready-to-use survey widgets – CSAT (2 or 5 points), CES (7 points), NPS (0–10)
• Multiple scale styles – emoji, stars, numbers, thumbs
• Flexible placement – embed inline or display as popup overlay
• Follow-up feedback – optional text input or multiple choice responses
• Optional email collection – close the loop by capturing a respondent's email when no user identity is known
• Fully customizable – CSS variables and custom class names
• Zero dependencies
• TypeScript support

Survey Types

• CSAT (Customer Satisfaction Score): 2-point (csat2) or 5-point (csat5) scales
• NPS (Net Promoter Score): 0–10 numeric scale (nps10)
• CES (Customer Effort Score): 7-point numeric scale (ces7)

Installation

1. Install

npm i react-feedback-surveys
# or
yarn add react-feedback-surveys

2. Styles

import 'react-feedback-surveys/index.css';