0
Fork 0
mirror of https://github.com/TanStack/router.git synced 2026-11-16 19:38:07 +00:00
router/examples/react/start-basic-auth
Sheraff fcddd16f20
chore(examples): ignore .tanstack/ in every Start example
The route generator writes its temporary files to .tanstack/tmp. Each
Start example now ignores the directory on its own, as a project copied
out of the monorepo (whose root ignores **/.tanstack). The five without a
.gitignore get start-basic's entries.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
History 2026-11-09 15:00:55 +01:00
..
.devcontainer docs: add devcontainer.json to all e2e/examples (#6972) 2026-03-18 15:43:14 +01:00
.vscode chore(examples): add .vscode/settings.json configuration (#3349) 2025-02-07 10:29:48 +13:00
prisma update start-basic-auth project to prisma 7 (#5911) 2025-11-20 19:44:02 +01:00
public feat(react-router): add context option to route (#2104) 2024-08-20 13:39:17 -06:00
src chore(examples): regenerate route trees through the example builds 2026-10-26 13:18:57 +01:00
.env feat(react-router): add context option to route (#2104) 2024-08-20 13:39:17 -06:00
.gitignore chore(examples): ignore .tanstack/ in every Start example 2026-11-09 15:00:55 +01:00
.prettierignore chore(examples): cleanup the deps for the start examples (#2388) 2024-09-21 22:21:59 +12:00
dev.db update start-basic-auth project to prisma 7 (#5911) 2025-11-20 19:44:02 +01:00
package.json ci: Version Packages (#8891) 2026-11-08 10:47:39 +01:00
prisma.config.ts update start-basic-auth project to prisma 7 (#5911) 2025-11-20 19:44:02 +01:00
README.md response reconciliation (#7588) 2026-10-13 00:01:04 +02:00
tsconfig.json chore: upgrade tooling to typescript 6 (#7024) 2026-03-23 22:59:52 +01:00
vite.config.ts docs: update examples/e2e to vite 8 (#6958) 2026-03-17 20:37:11 +01:00

TanStack Start - Basic Auth Example

A TanStack Start example demonstrating authentication patterns and protected routes.

Start a new project based on this example

To start a new project based on this example, run:

npx gitpick TanStack/router/tree/main/examples/react/start-basic-auth start-basic-auth

Getting Started

From your terminal:

pnpm install
pnpm dev

This starts your app in development mode, rebuilding assets on file changes.

Build

To build the app for production:

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 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:

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.