Skip to content

docs: add Thinking in Next.js guide#93442

Draft
aurorascharff wants to merge 32 commits into
canaryfrom
aurorascharff/thinking-in-nextjs
Draft

docs: add Thinking in Next.js guide#93442
aurorascharff wants to merge 32 commits into
canaryfrom
aurorascharff/thinking-in-nextjs

Conversation

@aurorascharff
Copy link
Copy Markdown
Contributor

@aurorascharff aurorascharff commented May 3, 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/.

Copilot AI review requested due to automatic review settings May 3, 2026 11:44
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 3, 2026

Hi there 👋

It looks like this PR introduces broken links to the docs, please take a moment to fix them before merging:

Broken link Type File
/docs/app/guides/server-actions link /docs/01-app/02-guides/thinking-in-nextjs.mdx
/docs/app/guides/runtime-prefetching link /docs/01-app/02-guides/thinking-in-nextjs.mdx
/docs/app/guides/offline-support link /docs/01-app/02-guides/thinking-in-nextjs.mdx
app/guides/server-actions related /docs/01-app/02-guides/thinking-in-nextjs.mdx
app/guides/runtime-prefetching related /docs/01-app/02-guides/thinking-in-nextjs.mdx
app/guides/offline-support related /docs/01-app/02-guides/thinking-in-nextjs.mdx

Thank you 🙏

@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 3, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a new App Router guide, “Thinking in Next.js”, that walks readers through building a small projects dashboard while introducing the key component-level decisions (data fetching, streaming, mutations, client interactivity, caching, and prefetching).

Changes:

  • Introduces a new end-to-end MDX tutorial structured as 8 incremental steps.
  • Embeds runnable demos for each step and links to the companion tutorial repo/source folders.
  • Documents Cache Components/PPR concepts in-context (Suspense placement, use cache, tagging, invalidation, and runtime prefetching).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

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

github-actions Bot commented May 3, 2026

Tests Passed

Commit: 52b530c

Comment thread docs/01-app/02-guides/thinking-in-nextjs.mdx Outdated
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.

2 participants