better-auth

mirror of https://github.com/better-auth/better-auth.git synced 2026-10-20 20:26:55 -05:00

Files

T

Claude 0d1ba97145 feat(oauth-provider): answer insufficient scope with a 403 insufficient_scope challenge

Per the MCP 2026-07-28 scope-challenge guidance (RFC 6750 §3.1),
raiseResourceServerChallenge now maps FORBIDDEN errors to a 403 with a
WWW-Authenticate challenge carrying error="insufficient_scope", the
required scope, and the resource_metadata pointer so MCP clients can
step up their authorization. requireMcpAuth and mcpHandler gain a
`scopes` option enforced against the token's scope claim, and awaited
handlers let handler-thrown FORBIDDEN errors produce the same challenge.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QbU1ZgRHK5A1btqpdR5gbD

2026-07-28 19:31:09 +00:00

app

chore(sync): merge main into next

2026-07-22 10:39:55 -04:00

assets

chore: merge landing app into docs (#8878 )

2026-04-01 13:38:37 +00:00

components

fix(device-authorization)!: add lookup indexes (#10059 )

2026-07-23 07:22:08 -04:00

content

feat(oauth-provider): answer insufficient scope with a 403 insufficient_scope challenge

2026-07-28 19:31:09 +00:00

hooks

chore: merge landing app into docs (#8878 )

2026-04-01 13:38:37 +00:00

lib

fix(device-authorization)!: add lookup indexes (#10059 )

2026-07-23 07:22:08 -04:00

public

docs(blog): add theme-aware cover images (#10470 )

2026-07-22 05:07:13 +09:00

scripts

chore(docs): relax typesense sync build (#9300 )

2026-04-22 09:19:21 +00:00

types

chore: merge landing app into docs (#8878 )

2026-04-01 13:38:37 +00:00

.env.example

docs: migrate AI chat from OpenRouter to Vercel AI Gateway (#10384 )

2026-07-13 14:28:42 -07:00

.gitignore

docs: Better Auth is joining Vercel announcement

2026-07-07 08:31:44 -07:00

.remarkrc.mjs

chore(docs): add remark-frontmatter (#9015 )

2026-04-07 15:35:57 +00:00

components.json

chore: merge landing app into docs (#8878 )

2026-04-01 13:38:37 +00:00

next.config.js

docs: rework AI resources documentation (#8856 )

2026-04-01 20:53:42 +00:00

package.json

fix(types): expand workspace and consumer type checking (#10505 )

2026-07-27 16:01:26 +00:00

postcss.config.mjs

chore: merge landing app into docs (#8878 )

2026-04-01 13:38:37 +00:00

README.md

docs: update brand assets (#9377 )

2026-04-29 20:04:16 +00:00

source.config.ts

docs(blog): add theme-aware cover images (#10470 )

2026-07-22 05:07:13 +09:00

tsconfig.json

chore: merge landing app into docs (#8878 )

2026-04-01 13:38:37 +00:00

vitest.config.ts

fix(device-authorization)!: add lookup indexes (#10059 )

2026-07-23 07:22:08 -04:00

README.md

Website & Docs

The main website and documentation for better-auth.com

Quick Start

# install
pnpm install

# develop
pnpm dev

Open localhost:3000 to preview.

Stack

Framework: Next.js 16 (App Router, Turbopack)
Styling: Tailwind CSS 4
Animation: Framer Motion
Docs: Fumadocs
Icons: Lucide React
Fonts: Geist Sans & Geist Mono

Structure

├─ app/
│  ├─ page.tsx              # Home — hero + sign-in demo
│  ├─ products/             # Products page
│  ├─ blog/                 # Blog posts
│  └─ docs/[[...slug]]/     # Documentation (MDX)
│
├─ components/
│  ├─ landing/              # Marketing components
│  ├─ docs/                 # Documentation components
│  ├─ ui/                   # Shared primitives
│  └─ icons/                # Brand icons & logo
│
├─ content/                 # MDX documentation files
│
├─ lib/
│  ├─ source.ts             # Fumadocs content source
│  └─ utils.ts              # Utilities
│
└─ public/
   └─ branding/             # Logo assets (SVG + PNG)

Scripts

pnpm dev          # Start dev server (Turbopack)
pnpm build        # Production build
pnpm start        # Serve production build
pnpm lint:fix     # Lint & auto-fix with Biome