Growth & Conversion
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.
$ velocityx add referral-invite-card
Built for react.
Needs react already installed
as a peer dependency.
An Astro-only project needs @astrojs/react wired up first — this won't run on its own in plain Astro.
Full docs for Referral Invite Card →
Needs a licence key —
subscribe here, then
velocityx loginonce.
Invite friends, earn free month
Share your link — 2 more to unlock free month.
Or share your code: 8F3K2M
Props
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| shareUrl | string | Yes | ||
| referralCode | string | No | ||
| rewardLabel | string | No | 'Free month' | |
| currentCount | number | No | 0 | |
| targetCount | number | No | 5 | |
| onInvite | (email: string) => Promise<void> | void | No | ||
| className | string | No | '' |
File this creates
The CLI writes this path into your project, relative to its root — nothing else moves.
components/velocity/referral-invite-card/ReferralInviteCard.tsxUsing the Referral Invite Card component
Install it with velocityx add referral-invite-card.
The CLI writes the source straight into your project — no runtime dependency, no registry
lock-in, and it themes itself from the same primary-*/accent-* scale as the rest of the library.
Related components
More from Growth & Conversion.
A persistent top-docked bar that resurfaces a cart left behind on any route, showing item count and total with Resume and Clear actions — a cross-page return nudge, not a cart panel.
reactA bottom-docked banner that nudges mobile visitors to open or install the native app, with iOS/Android-aware copy and store links, and a dismissal that snoozes for two weeks instead of forever.
reactAn inline deadline banner for a sale or launch window that counts down and then degrades gracefully to a plain closing message the instant it ends — never a broken negative-time state. Dismissible and remembered for the session.
reactA claim-to-reveal discount code card with one-tap copy and an expiry note, so the offer reads as earned rather than just printed on the page.
react