Referral Components

The Referral components are reusable React components designed to facilitate user referrals and rewards. It allows users to earn rewards by sharing a referral code with friends.

Component Visuals

To unlock early access to the component Get Access

Demo

Installation

To install the Quest react-sdk into your project, follow these steps:

  • Open your terminal/command prompt.

  • Navigate to your project's root directory using the cd command if you're not already there.

  • Run the following command to install the quest-sdk package using npm:

npm install @questlabs/react-sdk

This command will download and install the package and its dependencies into your project.

Make sure your project has npm and Node.js installed, and that you have the necessary permissions to install packages in your project directory.

Features

The ReferEarn component offers the following features:

  1. Referral Code Retrieval: It fetches a unique referral code for the user, which they can share with others to earn rewards.

  2. Copy to Clipboard: Users can easily copy their referral code to the clipboard with a single click, simplifying the sharing process.

  3. Social Media Sharing: The component provides icons for sharing the referral code on popular social media platforms, such as Twitter and Telegram.

  4. Customization: Users can customize the appearance of the component by specifying the color and bgColor props to match their application's design.

Props

The ReferEarn component accepts the following props:

You can customize the UI with type of styleConfig would be

styleConfig?: {
        Form?: CSSProperties,
        Label?: CSSProperties,
        Input?: CSSProperties,
        TextArea?: CSSProperties,
        PrimaryButton?: CSSProperties,
        SecondaryButton?: CSSProperties,
        Modal?: CSSProperties,
        Topbar?: CSSProperties,
        Heading?: CSSProperties,
        Description?: CSSProperties,
        Icon?: CSSProperties,
        Footer: {
            FooterStyle: CSSProperties,
            FooterText: CSSProperties,
            FooterIcon: CSSProperties
         },
    }

Usage

Import the component:

import { ReferEarn, QuestProvider } from '@questLabs/react-sdk';

Include the component in your JSX:

<QuestProvider
        apiKey="your api key"
        entityId="your entityid"
        featureFlags={{}}
        themeConfig={{
          primaryColor: '',
          secondaryColor: '',
          borderColor: '',
          buttonColor: '',
          backgroundColor: 'white',
          fontFamily: '',
       }}
        >
          <ReferEarn
             questId="your quest id"
             token="your token"
             userId="your user id"
             heading="Referral link and code"
             description="Share your unique referral code with friends and receive 10 coins in credits each time a friend signs up!"
             referralLink="https://www.questlabs.ai/"
             shareButtonText="Copy Referral Link"
             gradientBackground={true}
             gradientBackgroundColor=''
             primaryHeading="Refer and earn!"
             primaryDescription="Welcome back, Please complete your details"
             showReferralCode={false}
             showRefferalLogo={true}
             styleConfig= {{
               Form: {},
               Heading: {},
               Description: {},
               Input: {},
               Label: {},
               TextArea: {},
               PrimaryButton: {},
               SecondaryButton: {},
               Modal: {},
               Footer: {
                  FooterStyle: {},
                  FooterText: {},
                  FooterIcon: {}
               },
               Icon: {}
             }}
             showFooter={true}
          />
       </QuestProvider>

Customize the appearance of the component by adjusting the color and bgColor props as needed.

The component will automatically fetch the user's referral code and display it along with the copy-to-clipboard button and social media sharing icons.

Example

Here's a simple example of how to use the ReferEarn component in a React application:

import React from 'react';
import { Referral } from '@questLabs/react-sdk';

function App() {
  return (
    <div>
      <h1>Earn Rewards with ReferEarn</h1>
      <QuestProvider
        apiKey="your api key"
        entityId="your entityid"
        featureFlags={{}}
        themeConfig={{
          primaryColor: '',
          secondaryColor: '',
          borderColor: '',
          buttonColor: '',
          backgroundColor: 'white',
          fontFamily: '',
       }}
        >
          <ReferEarn
             questId="your quest id"
             token="your token"
             userId="your user id"
             heading="Referral link and code"
             description="Share your unique referral code with friends and receive 10 coins in credits each time a friend signs up!"
             referralLink="https://www.questlabs.ai/"
             shareButtonText="Copy Referral Link"
             gradientBackground={true}
             gradientBackgroundColor=''
             primaryHeading="Refer and earn!"
             primaryDescription="Welcome back, Please complete your details"
             showReferralCode={false}
             showRefferalLogo={true}
             styleConfig= {{
               Form: {},
               Heading: {},
               Description: {},
               Input: {},
               Label: {},
               TextArea: {},
               PrimaryButton: {},
               SecondaryButton: {},
               Modal: {},
               Footer: {
                  FooterStyle: {},
                  FooterText: {},
                  FooterIcon: {}
               },
               Icon: {}
             }}
             showFooter={true}
             // To run below props run on the local react app 
             // isOpen={isOpen}
             // onClose={() => setOpen(false)}
          />
       </QuestProvider>
 
    
    </div>
  );
}

export default App;

PreviousExpansionNextCross-Selling Component

Last updated