Referral Invite Card

A self-contained referral panel for a dashboard or account page — a copyable share link, an invite-by-email field, and a reward progress bar showing exactly how close the user is to their next unlock. Copy works without a toast library and confirms via screen-reader text, with a clipboard fallback for locked-down browsers.

Growth & Conversion · React · Subscription · commercial licence · v1.0.2 · updated 2026-10-15 · Live demo

Install

velocityx add referral-invite-card

Subscription component. Run velocityx login with your key first — get one.

---
import ReferralInviteCard from '../components/velocity/referral-invite-card/ReferralInviteCard.tsx';
---
<ReferralInviteCard client:visible />

Props

Prop	Type	Default	Description
shareUrl	string	required	—
referralCode	string	—	—
rewardLabel	string	'Free month'	—
currentCount	number	0	—
targetCount	number	5	—
onInvite	(email: string) => Promise<void> | void	—	—
className	string	''	—

Files written

velocityx drops these into your project:

• components/velocity/referral-invite-card/ReferralInviteCard.tsx

Peer dependencies

react — nothing else. Zero external dependencies is the point.

Theming

Colours come from the primary-* / accent-* Tailwind scales, so this drops into a project that is not Velocity without dragging our brand in. Install the contract once:

velocityx theme

Then set your whole brand in one place — raw RGB channels, not hex (a hex here silently breaks every opacity variant):

:root {
  --vx-brand: custom;
  --vx-primary-600: 220 38 38;
}

There is no component-level font-family anywhere in the library — your font cascade wins.

Licence

Commercial, for the duration of an active Velocity X subscription. The source is served by the licence-gated endpoint, never by the public CDN.