Skip to main content
Docs

Build your own sign-in-or-up page for your TanStack React Start app with Clerk

This guide shows you how to use the <SignIn /> component to build a custom page that allows users to sign in or sign up within a single flow.

To set up separate sign-in and sign-up pages, follow this guide, and then follow the custom sign-up page guideTanstack Start Icon.

Note

Just getting started with Clerk and TanStack React Start? See the quickstart tutorialTanstack Start Icon!

Build a sign-in-or-up page

The following example demonstrates how to render the <SignIn /> component on a dedicated page using the TanStack Router catch-all route.

src/routes/sign-in.$.tsx
import { SignIn } from '@clerk/tanstack-react-start'
import { createFileRoute } from '@tanstack/react-router'

export const Route = createFileRoute('/sign-in/$')({
  component: Page,
})

function Page() {
  return <SignIn />
}

Configure your sign-in-or-up page

Set the CLERK_SIGN_IN_URL environment variable to tell Clerk where the <SignIn /> component is being hosted.

There are other environment variables that you can set to customize Clerk's redirect behavior, such as CLERK_SIGN_IN_FORCE_REDIRECT_URL. Learn more about these environment variables and how to customize Clerk's redirect behavior in the dedicated guide.

.env
CLERK_SIGN_IN_URL=/sign-in

Visit your new page

Run your project with the following command:

terminal
npm run dev
terminal
pnpm run dev
terminal
yarn dev
terminal
bun run dev

Visit your new custom page locally at localhost:3000/sign-in.

Next steps

Learn more about Clerk components, how to use them to create custom pages, and how to use Clerk's client-side helpers using the following guides.

Create a custom sign-up page

Learn how to add a custom sign-up page to your TanStack React Start app with Clerk's components.

Protect content and read user data

Learn how to use Clerk's hooks and helpers to protect content and read user data in your TanStack React Start app.

Client-side helpers

Learn more about Clerk's client-side helpers and how to use them.

Prebuilt components

Learn how to quickly add authentication to your app using Clerk's suite of components.

Clerk TanStack React Start SDK Reference

Learn about the Clerk TanStack React Start SDK and how to integrate it into your app.

Feedback

What did you think of this content?

Last updated on

GitHubEdit on GitHub