Which UI do you use?

Custom UI

Pre built UI

How to use

Use the override config

ReactJS

info

See all the functions that can be overrided here

// this goes in the auth route config of your frontend app (once the pre built UI script has been loaded)
supertokensUIInit("supertokensui", {
    appInfo: {
        apiDomain: "...",
        appName: "...",
        websiteDomain: "...",
    },
    recipeList: [
        supertokensUIEmailPassword.init({
            override: {
                functions: (originalImplementation) => {
                    return {
                        ...originalImplementation,

                        // we will only be overriding what happens when a user
                        // clicks the sign in button.
                        signIn: async function (input) {
                            // TODO: some custom logic

                            // or call the default behaviour as show below
                            return originalImplementation.signIn(input);
                        },
                        // ...
                        // TODO: override more functions
                    }
                }
            }
        })
    ]
});

Angular

info

See all the functions that can be overrided here

import SuperTokens from "supertokens-auth-react";
import EmailPassword from "supertokens-auth-react/recipe/emailpassword";

SuperTokens.init({
    appInfo: {
        apiDomain: "...",
        appName: "...",
        websiteDomain: "..."
    },
    recipeList: [
        EmailPassword.init({
            override: {
                functions: (originalImplementation) => {
                    return {
                        ...originalImplementation,

                        // we will only be overriding what happens when a user
                        // clicks the sign in button.
                        signIn: async function (input) {
                            // TODO: some custom logic

                            // or call the default behaviour as show below
                            return originalImplementation.signIn(input);
                        },
                        // ...
                        // TODO: override more functions
                    }
                }
            }
        })
    ]
});

Vue

info

See all the functions that can be overrided here

// this goes in the auth route config of your frontend app (once the pre built UI script has been loaded)
supertokensUIInit("supertokensui", {
    appInfo: {
        apiDomain: "...",
        appName: "...",
        websiteDomain: "...",
    },
    recipeList: [
        supertokensUIEmailPassword.init({
            override: {
                functions: (originalImplementation) => {
                    return {
                        ...originalImplementation,

                        // we will only be overriding what happens when a user
                        // clicks the sign in button.
                        signIn: async function (input) {
                            // TODO: some custom logic

                            // or call the default behaviour as show below
                            return originalImplementation.signIn(input);
                        },
                        // ...
                        // TODO: override more functions
                    }
                }
            }
        })
    ]
});

• originalImplementation is an object that contain functions that have the original implementation for this recipe. They can be used in your functions as a way to use the SuperTokens' default behaviour.
• In the above code snippet, we override the signIn function of this recipe. This means that when the user clicks the sign in button in the UI, your function will be called with the relevant input object.