Which UI do you use?

Custom UI

Pre built UI

How to use

1. You will need to modify the Passwordless.init(...) function call.
2. Component overrides can be configured at override.components config object.
3. Pick a component that you'd like to override by its key.
4. Supply a React component against the key you have picked. Your custom component will get the original component as a prop.

Example

ReactJS

Note

You can use the supertokens-web-js SDK which exposes several helper functions that query the APIs exposed by the SuperTokens backend SDK.

You can refer to this example app as a reference for using the supertokens-web-js SDK.

Angular

Note

To use SuperTokens with React Native you need to use the supertokens-react-native SDK. The SDK provides session management features.

To add login functionality, you need to build your own UI and call the APIs exposed by the backend SDKs. You can find the API spec here

Vue

What type of UI are you using?

Prebuilt UICustom UI

Plain JavaScript

What type of UI are you using?

Prebuilt UICustom UI

React Native

import React from "react";
import { SuperTokensWrapper } from "supertokens-auth-react";
import { PasswordlessComponentsOverrideProvider } from "supertokens-auth-react/recipe/passwordless";

import octocat from "./octocat.png";

function App() {
    return (
        <SuperTokensWrapper>
            <PasswordlessComponentsOverrideProvider
                components={{
                    PasswordlessSignInUpHeader_Override: ({ DefaultComponent, ...props }) => {
                        // In this case, the <PasswordlessSignInUpHeader_Override> 
                        // will render the original component
                        // wrapped in a div with an octocat picture above it.
                        return (
                            <div>
                                <img src={octocat} />
                                <DefaultComponent {...props} />
                            </div>
                        );
                    }
                }}>
                {/* Rest of the JSX */}
            </PasswordlessComponentsOverrideProvider>
        </SuperTokensWrapper>
    );
}
export default App;

important

Please make sure that the file in which this config is specified is a .tsx or .jsx file type.

Finding which component will be overridden

To do that, you should use React Developer Tools extension which provides a component tree inspector.

Example

1. Look for the names defined in component override config and/or components ending in _Override in the component tree.
2. Ensure that's the component you want to override
3. Overide the component as stated above.

How do I render the original component

Because the override function receives the original component as a parameter, you can render it. To do this, simply use it in JSX. Don't forget to supply original props by spreading them.

import React from "react";
import { SuperTokensWrapper } from "supertokens-auth-react";
import { PasswordlessComponentsOverrideProvider } from "supertokens-auth-react/recipe/passwordless";

import octocat from "./octocat.png";

function App() {
    return (
        <SuperTokensWrapper>
            <PasswordlessComponentsOverrideProvider
                components={{
                    PasswordlessSignInUpHeader_Override: ({ DefaultComponent, ...props }) => {
                        return (
                            <>
                                <h1>I'm a header that you added above original component</h1>
                                <DefaultComponent {...props} />
                            </>
                        )
                    }
                }}>
                {/* Rest of the JSX */}
            </PasswordlessComponentsOverrideProvider>
        </SuperTokensWrapper>
    );
}
export default App;