Referral widget

Turn happy users into your growth channel

Every user gets their own referral link to copy or share. RoastNest tracks the signups and purchases it brings in, and tells your backend when a reward is earned.

Try it live

This is the real referral widget, running right here.

How it works

Referral widget in three steps

  1. 1

    Share

    Users copy their link or share it through their phone's share sheet.

  2. 2

    Track

    A friend arrives, and the referral is remembered until they convert.

  3. 3

    Reward

    Qualifying conversions trigger rewards for the referrer and the friend.

What you get

Free to start. Marked features come with paid plans.

One link per user

The same link on every device, generated and stored for you.

Copy and share

A copy button plus native sharing, with the reward explained on the card.

Conversion tracking

Track signups and purchases with one call. Referrals survive page changes.

Two-sided rewards

Reward the person sharing and the friend who joined, each with their own reward.

Automatic rewards

When a conversion qualifies, a signed webhook tells your backend to grant it.

Identify your way

Link referrers by your own user id, or by email when that's all you have.

Built for

Where teams use it most

SaaS signups

Give a free month to both sides when a friend upgrades.

Marketplaces and apps

Credits or coupons for every friend who makes a first purchase.

Waitlists and launches

Let early users bring friends and see who drives the most.

Add referrals in minutes

Install the package and drop it in

npm install @roastnest/react
import { ReferralWidget, useReferral } from "@roastnest/react";

// 1. Show each user their link
<ReferralWidget referrerIdentity={{ id: user.id, name: user.name }} />

// 2. Track the conversion when a referred friend signs up
const { track, hasReferral } = useReferral();
if (hasReferral) track.signup();

Full referral widget docs

Frequently Asked Questions

About the referral widget

Add the referral widget today

Free to start, no card needed.