Skip to content

docs: add Thinking in Next.js guide#93410

Closed
aurorascharff wants to merge 25 commits into
vercel:canaryfrom
aurorascharff:aurorascahrff/thinking-in-nextjs
Closed

docs: add Thinking in Next.js guide#93410
aurorascharff wants to merge 25 commits into
vercel:canaryfrom
aurorascharff:aurorascahrff/thinking-in-nextjs

Conversation

@aurorascharff
Copy link
Copy Markdown
Contributor

@aurorascharff aurorascharff commented May 1, 2026

What?

A new "Thinking in Next.js" guide that walks through building a small Vercel-style projects dashboard one decision at a time, mirroring the structure of React's Thinking in React.

Why?

Help readers form a mental model of App Router apps as components that decide where their data comes from, what gets reused, and what stays in the browser. The progression covers the eight choices each component answers: hierarchy, static JSX, data fetching, streaming, mutations, client interactivity, caching, and prefetching.

How?

  • New MDX guide at docs/01-app/02-guides/thinking-in-nextjs.mdx, sitting alongside instant-navigation.mdx, forms.mdx, etc.
  • Companion runnable app per step lives at vercel-labs/thinking-in-nextjs with one folder per guide step, deployed under *.labs.vercel.dev and embedded via <Demo /> in each step. Final step: https://thinking-in-nextjs.labs.vercel.dev/
  • Mockup images uploaded to the docs blob at /docs/guides/thinking-in-nextjs/.

@github-actions github-actions Bot added created-by: Next.js DevEx team PRs by the DX team. Documentation Related to Next.js' official documentation. labels May 1, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 1, 2026

Failing CI jobs

Commit: cd0773c | About building and testing Next.js

Comment thread docs/01-app/02-guides/thinking-in-nextjs.mdx Outdated
Comment thread docs/01-app/02-guides/thinking-in-nextjs.mdx Outdated
@aurorascharff
Copy link
Copy Markdown
Contributor Author

Superseded by #93442 (same content, branch now lives on vercel/next.js instead of my fork).

@aurorascharff aurorascharff deleted the aurorascahrff/thinking-in-nextjs branch May 3, 2026 11:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

created-by: Next.js DevEx team PRs by the DX team. Documentation Related to Next.js' official documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant