# TanStack Start - Basic Auth Example A TanStack Start example demonstrating authentication patterns and protected routes. - [TanStack Router Docs](https://tanstack.com/router) ## Start a new project based on this example To start a new project based on this example, run: ```sh npx gitpick TanStack/router/tree/main/examples/react/start-basic-auth start-basic-auth ``` ## Getting Started From your terminal: ```sh pnpm install pnpm dev ``` This starts your app in development mode, rebuilding assets on file changes. ## Build To build the app for production: ```sh pnpm build ``` ## Authentication Features This example demonstrates: - User authentication flow - Protected routes - Login/logout functionality - Redirect after authentication ## Session configuration This example uses [iron-session](https://github.com/vvo/iron-session) through Start's `getCookie` and `setCookie` helpers. Set `SESSION_PASSWORD` to a random secret of at least 32 characters before starting the app, for example: ```sh export SESSION_PASSWORD="$(openssl rand -base64 32)" ``` Keep the same secret across instances and deployments that must read the same sessions. The cookie requires HTTPS in production. Each handler reads its own session, then awaits `session.save()` before redirecting or returning.