nextjs - 💡(How to fix) Fix Update docs to reflect omission of `NEXT_` prefix. And everything else. And stop, please. [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
vercel/next.js#85061Fetched 2026-04-08 02:17:32
View on GitHub
Comments
1
Participants
2
Timeline
6
Reactions
0
Timeline (top)
labeled ×2closed ×1commented ×1issue_type_added ×1

Root Cause

Update docs to reflect omission of NEXT_ prefix *its all over the place. And you dont know which version its referring to. Please maintain consistency and push for relevance in your docs. I have to be honest. I've never spent longer on anything in 22yrs of my career than trying to understand a single piece of tech with such insanely abstract references to usages without any context applied (such as 'usage: some async operation' without any guidance around whether that's a component level thing, client component, server, onClick event etc). Lacking paramounts of context and especially dying at the oAuth end. Zero follow through on cookie usage for oAuth, JWT necessities--which happen to be required regardless of the even more bloated crossover with next-auth-better-auth-but-not-totally-better-auth-but-is--move to get any scoped API data back. I have wasted over a year just on NextJS and that's because i like things being in an 'app' folder. That's it. I'm only writing this as a courtesy that to any new devs or even intermediate, this is hell. And it's gotten worse with every new partner merge and update. Thanks,

Code Example

all environments
RAW_BUFFERClick to expand / collapse

Link to the code that reproduces this issue

https://authjs.dev/getting-started/installation?framework=Next.js

To Reproduce

Update docs to reflect omission of NEXT_ prefix *its all over the place. And you dont know which version its referring to. Please maintain consistency and push for relevance in your docs. I have to be honest. I've never spent longer on anything in 22yrs of my career than trying to understand a single piece of tech with such insanely abstract references to usages without any context applied (such as 'usage: some async operation' without any guidance around whether that's a component level thing, client component, server, onClick event etc). Lacking paramounts of context and especially dying at the oAuth end. Zero follow through on cookie usage for oAuth, JWT necessities--which happen to be required regardless of the even more bloated crossover with next-auth-better-auth-but-not-totally-better-auth-but-is--move to get any scoped API data back. I have wasted over a year just on NextJS and that's because i like things being in an 'app' folder. That's it. I'm only writing this as a courtesy that to any new devs or even intermediate, this is hell. And it's gotten worse with every new partner merge and update. Thanks,

Current vs. Expected behavior

get data back from linkedin auth via next auth + supabase then display it on a page.

Provide environment information

all environments

Which area(s) are affected? (Select all that apply)

Dynamic Routes

Which stage(s) are affected? (Select all that apply)

next dev (local)

Additional context

No response

extent analysis

TL;DR

Update the documentation to consistently use the NEXT_ prefix and provide clear context for usage, especially regarding OAuth and JWT necessities.

Guidance

  • Review the Next.js documentation and update it to reflect consistent usage of the NEXT_ prefix.
  • Provide clear examples and context for OAuth and JWT usage, including component-level and server-side implementation.
  • Consider adding a step-by-step guide for implementing LinkedIn authentication with Next Auth and Supabase.
  • Verify that the documentation covers the requirements for getting scoped API data back.

Example

No code snippet is provided as the issue is related to documentation and context rather than a specific code problem.

Notes

The issue lacks specific technical details, and the provided information is more related to the frustration with the documentation and usage of Next.js. The guidance provided is based on the assumption that improving the documentation and providing clear context will help resolve the issue.

Recommendation

Apply workaround: Improve the documentation to provide clear context and usage examples, especially for OAuth and JWT necessities, to help developers understand and implement the required functionality.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING