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

Refer Earn

Refer Share

To unlock early access to the component Get Access

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.

---

Usage

To integrate the ReferEarn component into your React application, follow these steps

• Import the CSS: In your JavaScript or TypeScript file where you're using the ReferEarn, import the CSS styles for the component. This ensures that the component's styling is applied correctly.

'@questlabs/react-sdk/dist/style.css'

• Import the TutorialComponent: Import the ReferEarncomponent from the @questlabs/react-sdk package.

• Import the QuestProvider Component: Import the QuestProvider component from the @questlabs/react-sdk package.

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

• Pass the Required Props: Pass the required props to the QuestProvider. The required props are apiKey, and entityId. and required props for the ReferEarncomponent are userId, questId, token

Replace "your-api-key" and "your-entity-id" with your actual Quest API credentials

Replace "your-token", "your-user-id", "your-questId" with your actual configuration details.

Code & Steps

QuestProvider

import { QuestProvider, ReferEarn } from '@questlabs/react-sdk';
import '@questlabs/react-sdk/dist/style.css'

function App() {
  return (
      <QuestProvider
        apiKey="your-apikey"
        entityId="your-entity-Id" 
        apiType= "PRODUCTION" // STAGING 
      >
      <ReferEarn> </ReferEarn>
      </QuestProvider>
  );
}

export default App;

ReferEarn

<ReferEarn
    userId=""
    questId=""
    token=""
    uniqueUserId="your-unique-user-id"
>
    // childrens
</ReferEarn>

Header

<ReferEarn.Header
    heading='your-heading' 
    description:""
/>

Footer

<ReferEarn.Footer
    text='your-company-name' 
    link='redirect-link'
    style={{ background : 'white' }}
/>

Preview

<QuestProvider
    apiKey="your-apikey"
    entityId="your-entity-Id"
    apiType="PRODUCTION" // STAGING 
>
    <ReferEarn
        userId=""
        questId=""
        token=""
        uniqueUserId="your-unique-user-id"
    >
        <ReferEarn.Header />
        <ReferEarn.MainContent />
        <ReferEarn.Footer />
    </ReferEarn>
</QuestProvider>

---

Example Usage

Here's an example of how to use the ReferEarn component within your React application

ReferEarn

import { QuestProvider, ReferEarn } from '@questlabs/react-sdk';
import '@questlabs/react-sdk/dist/style.css'

function App() {
    return (
        <div>
            <QuestProvider
                apiKey="your-apikey"
                entityId="your-entity-Id"
                apiType="PRODUCTION" // STAGING 
            >
                <ReferEarn
                    userId=""
                    questId=""
                    token=""
                    uniqueUserId="your-unique-user-id"
                >
                    <ReferEarn.Header />
                    <ReferEarn.MainContent/>
                    <ReferEarn.Footer />
                </ReferEarn>
            </QuestProvider>
        </div>
    );
}

export default App;

ReferEarnWrapper

import { QuestProvider, ReferEarnWrapper } from '@questlabs/react-sdk';
import '@questlabs/react-sdk/dist/style.css'

function App() {
  return (
    <div>
      <QuestProvider
        apiKey="your-apikey"
        entityId="your-entity-Id"
        apiType= "PRODUCTION" // STAGING 
      >
       <ReferEarnWrapper
          userId=""
          questId=""
          token=""
          uniqueUserId="your-unique-user-id"
          styleConfig= {{
              Form: {},
              Heading: {},
              Description: {},
              Footer: {},
              TopBar: {},
          }}
          showFooter={false}
        />
      </QuestProvider>
    </div>
  );
}

export default App;

Props

The ReferEarn component accepts the following props:

questId	string	required	The unique identifier for the referral quest associated with the user.
userId	string	required	The user's unique identifier, often used for tracking referrals.
token	string	required	A user authentication token required for making API requests.
heading	string	optional	Heading for the referral component.
headingColor	string	optional	set the heading color
description	string	optional	Description for the referral component.
referralLink	string	optional	Referral link.
shareButtonText	string	optional	Text for the share button.
secondaryIconColor	string	optional	Color of secondary icons.
gradientBackground	boolean	optional	Indicates whether to use a gradient background.
primaryHeading	string	optional	Primary heading for the gradient background.
primaryDescription	string	optional	Primary description for the gradient background.
onCopy	function	optional	Callback function triggered on referral code copy.
showReferralCode	boolean	optional	Indicates whether to show the referral code.
isOpen	boolean	optional	if true open the component else not
bgColor	string	optional	set background color
uniqueUserId	string	optional	a unique user'id for all user
showPoweredBy	boolean	optional	Indicates whether to show the "Powered by QuestLabs" footer.
uniqueEmailId	string	optional	a unique email'id for all user
styleConfig	object	optional	An object containing CSS properties for styling various components within the refer earn process, including form, topbar, label, headings, descriptions, Primary button .

The above example uses all the props.

You can customize the UI with type of styleConfig would be

styleConfig= {{
    Form: {},
    Heading : {},
    Description : {},
    Footer: {
    FooterStyle: {},
    FooterText: {},
    FooterIcon: {}
    },
    TopBar: {},
}}

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.

Demo