Skip to main content
Docs

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

By default, the <SignIn /> component handles signing in and signing up, but if you'd like to have a dedicated sign-up page, this guide shows you how to use the <SignUp /> component to build a custom sign-up page.

To set up a single sign-in-or-up page, follow the custom sign-in-or-up page guideTanstack Start Icon.

Note

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

Build a sign-up page

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

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

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

function Page() {
  return <SignUp />
}

Configure your sign-up page

  • Set the CLERK_SIGN_UP_URL environment variable to tell Clerk where the <SignUp /> component is being hosted.

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

.env
CLERK_SIGN_UP_URL=/sign-up

Visit your new pages

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-up.

Next steps

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

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.

Customization & localization

Learn how to customize and localize Clerk 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