Gatsby ↔️ Stytch Migration Guide

Stytch Account Setup

Create your Stytch account following our Stytch Account Setup guide.

Add your public key to the .env

You can find your public token in the Stytch dashboard.

GATSBY_PUBLIC_STYTCH_API_KEY={your_token}

Also remove the magic key from your .env if you have one.

Install Stytch and gatsby-theme-autonomy

npm install @stytch/nextjs @stytch/vanilla-js @chordcommerce/gatsby-theme-autonomy@^5.0.0

Add a StytchProvider

Create a new file called "AuthProvider" and paste the following code:

Then wrap element in your gatsby-browser.js file with the AuthProvider:

<AuthProvider>{element}</AuthProvider>

Add a LoginForm component that uses StytchLogin

Go to the config docs to see what options are available.

Create an Authenticate component

This component will authenticate the user by calling handleCallback() from useAuth, then it will navigate to the /account page.

Add this component to the pages directory:

Try it out

Visit your login page and try logging in using a magic link!

Once you've clicked the link in the email from Stytch to sign-up/login, you can visit the user management page to see your user.

Enabling OAuth

If your would like to enable OAuth, visit the SDK Configuration page, and click the OAuth toggle. Then, expand the OAuth section and toggle Enable PKCE.

Once OAuth is enabled, visit the OAuth page, then select the provider you would like to use and follow the directions.