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

• A single Survey component – the format (methodology, scale length, visual style) is configuration, not a different import
• Ready-to-use survey formats – 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

Survey covers three feedback methodologies, selected with the type prop. CSAT is the only one with a variable scale length, set via points:

• CSAT (Customer Satisfaction Score): type="csat", 2-point or 5-point scale (points={2} or points={5})
• NPS (Net Promoter Score): type="nps", fixed 0–10 scale
• CES (Customer Effort Score): type="ces", fixed 7-point scale

Installation

1. Install

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

2. Styles

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