Introduction to FeatureDrop
FeatureDrop is a production-ready, open-source React toolkit for building product adoption experiences.
If you've ever built a SaaS app, you eventually need to announce new features to your users, guide them through onboarding tours, or collect their feedback. Traditionally, teams either spend weeks building these components from scratch, or they pay thousands of dollars a month for bulky third-party widgets like Beamer or Appcues.
FeatureDrop gives you a middle path: beautiful, highly-functional adoption components that run directly inside your own React tree, powered by your own data.
How it works
The entire system revolves around a simple, three-part architecture:
- The Manifest: A single JSON or TypeScript configuration file where you declare all of your products, features, tours, and their metadata. This is your source of truth.
- The Provider: A lightweight React context provider (
<FeatureDropProvider>) that sits near the top of your app tree. It parses your manifest and tracks which features a user has seen or interacted with. - The Components: Drop-in UI primitives like
<ChangelogWidget>,<Tour>, or<NewBadge>that automatically read from the Provider to display the right content at the right time.
FeatureDrop ships with usable defaults and render-prop escape hatches, so you can move fast first and customize deeply when needed.
Where to start?
Choose your path based on what you need to achieve today:
Quickstart Guide
Get the library installed, configure a basic manifest, and render your first unread badge in under 10 minutes.
Component Gallery
Browse interactive demos of the Changelog, Tours, Spotlights, and Surveys, and see how to drop them into your app.
Core Architecture
Deep dive into the schema definitions, version targeting logic, and the React context state machine.
Storage Adapters
Learn how to persist "read state" via LocalStorage, IndexedDB, or sync it securely to your own PostgreSQL database.