Disable Unwanted Functionality

By default, almost all of Catalyst's functionality is enabled. To add or remove options or utilities, use the disable set of props:

• disableChat hides the built-in text chat button and sidebar
• disableNameField hides the name input box on the setup screen
• disableSetupView disables the setup screen entirely
• disableRefreshBtn disables the refresh button in Catalyst's top settings bar
• disableSelfieMode disables auto-correction of the uncanny-valley effect that flips portrait cameras

Below is an example component where the chat and setup screen are disabled

xxxxxxxxxx

     <CatalystChat

        room="EXAMPLE"

        appId="YOUR_CATALYST_PROJECT_ID"

        name="MEMBER_NAME"

        disableChat

        disableSetupRoom

        onEndCall={() => alert("Call ended!")}

    />

​

Welcome Text Customization

You can customize the welcome message with cstmWelcomeMsg. For example, in the component below:

xxxxxxxxxx

     <CatalystChat

        room="EXAMPLE"

        appId="YOUR_CATALYST_PROJECT_ID"

        name="MEMBER_NAME"

        cstmWelcomeMsg="Welcome to the party!"

        onEndCall={() => alert("Call ended!")}

    />

​

Your custom welcome message can also be any react JSX or HTML element.

Support Customization

When Catalyst runs into any problems, whether because of network issues, token generations errors, etc - it shows a "contact support" message that links to our support form. You can alter this to your own if you wish using the cstmSupportUrl parameter. An example is below:

xxxxxxxxxx

     <CatalystChat

        room="EXAMPLE"

        appId="YOUR_CATALYST_PROJECT_ID"

        name="MEMBER_NAME"

        cstmSupportUrl="https://catalyst.chat/contact"

        onEndCall={() => alert("Call ended!")}

    />

​

You can also pass an email in the format mailto:youremail@company.com, which will cause Catalyst to open the link in the user's default email client.

The ability to hide toolbar buttons and add your own are coming soon. If these specific props are really important to you, send us a note!