Stytch and frontend development (pre-built UI)

Our frontend and mobile SDKs offer pre-built UI components for an out-of-the-box developer experience. Get started in minutes with ready-to-use login and signup forms. Configure your preferred auth methods and customize the styles to match your app’s brand. This guide covers the fundamental aspects and key considerations when implementing pre-built UI with our frontend SDKs.

Here’s a list of libraries and options we offer for frontend development with pre-built UI components:

• Frontend SDKs
  • JavaScript SDK
  • Next.js SDK
  • React SDK

Refer to the SDK UI config reference page for full documentation. Explore the example apps to get hands-on with the code.

We also offer AuthKit, an interactive frontend SDK builder, that you can use to demo our pre-built UI components with just a few clicks.

At a high-level, implementing Stytch on the client-side with pre-built UI involves the following steps:

1. The end user attempts to log into your application with Stytch’s pre-built UI components configured on your frontend.
2. Stytch’s frontend SDK automatically handles the UI events and calls the Stytch API with the necessary authentication data.
3. The Stytch API processes the request and returns a response with pertinent data.
4. Your frontend handles the response as needed via event callbacks or redirect urls, which may involve using Stytch's frontend SDK headlessly, updating your UI, or relaying the data to your backend.
5. Once the end user successfully authenticates, Stytch’s frontend SDK automatically manages the storage of session tokens using browser cookies or mobile storage.

The pre-built UI approach is a great way to quickly configure production-ready login forms for your application. However, if you require more client-side control over the UI or the auth flow logic, we recommend using our frontend SDK headlessly where needed.

Here are some example code snippets that demonstrate the general idea of implementing our pre-built UI.

import { StytchB2B } from "@stytch/nextjs/b2b";
import { B2BProducts, AuthFlowType } from "@stytch/vanilla-js";

const Login = () => {
  const REDIRECT_URL = "http://localhost:3000/authenticate";
  // Configure the pre-built UI and authentication methods
  const config = {
    authFlowType: AuthFlowType.Discovery,
    products: [B2BProducts.emailMagicLinks, B2BProducts.oauth],
    emailMagicLinksOptions: {
      loginRedirectURL: REDIRECT_URL,
      loginExpirationMinutes: 60,
      signupRedirectURL: REDIRECT_URL,
      signupExpirationMinutes: 60,
      discoveryRedirectURL: REDIRECT_URL,
    },
    oauthOptions: {
      providers: [{ type: "google" }, { type: "microsoft" }],
      loginRedirectURL: REDIRECT_URL,
      signupRedirectURL: REDIRECT_URL,
      discoveryRedirectURL: REDIRECT_URL,
    },
  };

  return <StytchB2B config={config} />;
...

// Apply custom styles to the pre-built UI components
const styles = {
  fontFamily: "Arial",
  hideHeaderText: false,
  logo: { logoImageUrl: IMAGE_URL },
  container: {
    backgroundColor: "#FFFFFF",
    width: "400px"
  },
  colors: {
    primary: "#19303D",
    success: "#0C5A56",
    error: "#8B1214"
  },
  buttons: {
    primary: {
      backgroundColor: "#19303D",
      textColor: "#FFFFFF",
    }
  },
  inputs: {
    borderColor: "#19303D",
    borderRadius: "4px",
  }
};

return <StytchB2B config={config} styles={styles} />;
...

// Add callback logic to auth events
const callbacks = {
  onEvent: ({ type, data }) => {
    if (type === "B2B_MAGIC_LINK_EMAIL_DISCOVERY_SEND") {
      // add frontend logic
    }
    if (type === "B2B_SSO_START") {
      // add frontend logic
    }
    if (type === "B2B_SSO_AUTHENTICATE") {
      // add frontend logic
    }
  }},
  onError: (err) => {
    console.error(err);
    // add frontend logic
  });
}

return <StytchB2B config={config} styles={styles} callbacks={callbacks} />;
...

When using our pre-built UI components, you will need to use our frontend SDK headlessly (or our backend API and SDKs) in order to implement certain auth features like session management and organization management.

// Revoke session
const LogOut = () => {
  const stytchB2BClient = useStytchB2BClient();

  const revokeSession = async () => {
    await stytchB2BClient.session.revoke();
    router.push("/");
  };
  return <button onClick={revokeSession}>Log out</button>
};

The main difference between the pre-built UI approach and the headless approach is how you handle the login and signup flows. With the headless approach, you need to wire your UI components to Stytch’s frontend SDK to trigger auth events. Beyond that, the two implementation methods are essentially the same.

We strongly advise reading the headless frontend SDK implementation guide, as it covers key considerations for client-side development that also apply to the pre-built UI approach.

Our pre-built UI components are hosted by your application on your domain.

Read the headless frontend SDK implementation guide.

If you have additional questions about our different integration options, please feel free to reach out to us in our community Slack, our developer forum, or at support@stytch.com for further guidance.