start-authjs

Auth.js integration for TanStack Start and SolidStart applications.

Documentation

View full documentation

Installation

npm install start-authjs @auth/core

Quick Start

1. Set Environment Variables

AUTH_SECRET=your-secret-key  # openssl rand -base64 32
AUTH_URL=http://localhost:3000/api/auth

# Provider-specific (e.g., Auth0)
AUTH_AUTH0_ID=your-client-id
AUTH_AUTH0_SECRET=your-client-secret
AUTH_AUTH0_ISSUER=https://your-tenant.auth0.com

2. Create Auth Configuration

// src/utils/auth.ts
import Auth0 from '@auth/core/providers/auth0'
import type { StartAuthJSConfig } from 'start-authjs'

export const authConfig: StartAuthJSConfig = {
  secret: process.env.AUTH_SECRET,
  providers: [Auth0()],
}

3. Create API Route

TanStack Start:

// src/routes/api/auth/$.ts
import { createFileRoute } from '@tanstack/react-router'
import { StartAuthJS } from 'start-authjs'
import { authConfig } from '~/utils/auth'

const { GET, POST } = StartAuthJS(authConfig)

export const Route = createFileRoute('/api/auth/$')({
  server: {
    handlers: {
      GET: ({ request }) => GET({ request, response: new Response() }),
      POST: ({ request }) => POST({ request, response: new Response() }),
    },
  },
})

SolidStart:

// src/routes/api/auth/[...solidauth].ts
import type { AuthRequestContext } from "start-authjs";
import { StartAuthJS } from 'start-authjs'
import { authConfig } from '~/utils/auth'

const { GET: AuthGET, POST: AuthPOST } = StartAuthJS(authConfig)

export const GET = (event: AuthRequestContext) => {
  return AuthGET({ request: event.request, response: new Response() })
}

export const POST = (event: AuthRequestContext) => {
  return AuthPOST({ request: event.request, response: new Response() })
}

4. Get Session

import { getSession } from 'start-authjs'
import { authConfig } from '~/utils/auth'

const session = await getSession(request, authConfig)

API

Export	Description
StartAuthJS	Creates GET/POST handlers for auth routes
getSession	Get current session from request
auth	Get session with cookie forwarding
authMiddleware	Middleware for protected routes
serverSignIn	Programmatic sign in
serverSignOut	Programmatic sign out

Examples

• TanStack Start + React + Auth0
• TanStack Start + Solid + Auth0
• SolidStart v1
• SolidStart v2 Alpha

Providers

All Auth.js providers are supported: GitHub, Google, Auth0, Discord, Credentials, and 80+ more.

License

MIT