Skip to content

Changed basePath in auth.ts to match the official documentation #13166

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Changed basePath in auth.ts to match the official documentation #13166

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ca2719b
Changed basePath in auth.ts to match the official documentation("/api…
jeremyko Aug 9, 2025
b9d6ad7
Merge branch 'main' into main
jeremyko Oct 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
0 ...es/nextjs/app/auth/[...nextauth]/route.ts → ...extjs/app/api/auth/[...nextauth]/route.ts
View file
Open in desktop
File renamed without changes.
2 changes: 1 addition & 1 deletion apps/examples/nextjs/auth.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -100,7 +100,7 @@ export const { handlers, auth, signIn, signOut } = NextAuth({
WorkOS({ connection: process.env.AUTH_WORKOS_CONNECTION! }),
Zoom,
],
basePath: "/auth",
basePath: "/api/auth",
Copy link
Contributor

@halvaradop halvaradop Aug 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The basePath option was configured to point to auth/[...nextauth] instead of api/auth/[...nextauth]. As you noted, the configuration is in auth/[...nextauth]/route.ts, not api/auth/[...nextauth].

next-auth/apps/examples/nextjs/app/auth/[...nextauth]/route.ts

Lines 1 to 2 in 39dd3b9

import { handlers } from "auth"
export const { GET, POST } = handlers

​The NextAuth.js documentation recommends using the api/auth structure. However, this isn't a strict requirement, as the basePath option was introduced specifically to allow for custom authentication routes. The user isn't obligated to configure their app with /api/auth.

Copy link
Author

@jeremyko jeremyko Aug 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, then I think the official documentation (https://authjs.dev/guides/configuring-github) needs to be revised. To avoid confusion, the documentation should explicitly specify "http://localhost:3000/auth/callback/github." We develop our code by referencing both the official documentation and the examples. It would be best if one of the two were revised to eliminate any inconsistencies.

session: { strategy: "jwt" },
callbacks: {
authorized({ request, auth }) {
Expand Down
2 changes: 2 additions & 0 deletions lefthook.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,6 @@ pre-commit:
commands:
format:
run: pnpm prettier --cache --write {staged_files}
exclude:
- apps/examples/nextjs/app/api/auth/*
stage_fixed: true