TanStack Start Integration
This integration guide is assuming you are using TanStack Start.
Before you start, make sure you have a Better Auth instance configured. If you haven't done that yet, check out the installation.
Mount the handler
We need to mount the handler to a TanStack API endpoint.
Create a new file: /app/routes/api/auth/$.ts
If you haven't defined an API Route yet, you can do so by creating a file: /app/api.ts
Usage tips
- We recommend using the client SDK or
authClient
to handle authentication, rather than server actions withauth.api
. - When you call functions that need to set cookies (like
signInEmail
orsignUpEmail
), you'll need to handle cookie setting for TanStack Start. Better Auth provides areactStartCookies
plugin to automatically handle this for you.
Now, when you call functions that set cookies, they will be automatically set using TanStack Start's cookie handling system.