Skip to content

docs: add Interactive Apps guide#94020

Merged
aurorascharff merged 33 commits into
canaryfrom
aurorascharff/interactive-apps-guide
Jun 23, 2026
Merged

docs: add Interactive Apps guide#94020
aurorascharff merged 33 commits into
canaryfrom
aurorascharff/interactive-apps-guide

Conversation

@aurorascharff

@aurorascharff aurorascharff commented May 21, 2026

Copy link
Copy Markdown
Contributor

What?

Adds the Interactive Apps guide (docs/01-app/02-guides/interactive-apps.mdx) with a companion Taskboard app.

Why?

There is no end-to-end guide that shows how to coordinate pending work across Server Functions, transitions, optimistic UI, and caching in a single app.

How?

The guide walks through building a task management board in 8 steps, from a plain Server Component app to one with optimistic UI, streaming, caching, and prefetching:

  1. Stream slow data with Suspense — promise-passing to split reads into independent boundaries
  2. Respond instantly to a toggle — useOptimistic + startTransition for a priority cycle
  3. Filter with pending feedback — useTransition + data-pending for label chips, action props for ChipGroup
  4. Add comments with instant feedback — useOptimistic([]) for a pending-only comment list
  5. Move cards between columns — optimistic reducer for drag-and-drop status updates
  6. Manage form lifecycle with useActionState — isPending, key-based reset, double-transition for dialog close
  7. Signal pending deletion to a parent — useOptimistic(false) + data-pending CSS attribute
  8. Make repeat navigation instant — use cache, cacheTag, updateTag, unstable_prefetch

The companion app lives at vercel-labs/async-react-demo. The plain branch is the starting point, main has all 8 steps applied.

@github-actions

github-actions Bot commented May 21, 2026

Copy link
Copy Markdown
Contributor

Tests Passed

Commit: 22918c5

Comment thread docs/01-app/02-guides/interactive-apps.mdx Outdated
@aurorascharff aurorascharff marked this pull request as ready for review May 25, 2026 11:51
Copilot AI review requested due to automatic review settings May 25, 2026 11:51

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 for building interactive applications with coordinated pending states across Server Functions, transitions, optimistic UI, Suspense streaming, caching, and runtime prefetching.

Changes:

  • Introduces an end-to-end Taskboard walkthrough with eight progressive interaction patterns.
  • Covers client/server coordination patterns such as useOptimistic, useTransition, useActionState, data-pending, use cache, cacheTag, updateTag, and unstable_prefetch.
  • Links to a companion demo and related Next.js documentation.

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

Comment thread docs/01-app/02-guides/interactive-apps.mdx
Comment thread docs/01-app/02-guides/interactive-apps.mdx Outdated
Comment thread docs/01-app/02-guides/interactive-apps.mdx Outdated
@aurorascharff aurorascharff requested a review from icyJoseph May 25, 2026 20:39
Comment thread docs/01-app/02-guides/interactive-apps.mdx Outdated
Yep, way better!

Co-authored-by: Joseph <joseph.chamochumbi@vercel.com>
@github-actions

github-actions Bot commented May 27, 2026

Copy link
Copy Markdown
Contributor

Stats skipped

Commit: 22918c5
View workflow run

Comment thread docs/01-app/02-guides/interactive-apps.mdx Outdated
Comment thread docs/01-app/02-guides/interactive-apps.mdx Outdated
Comment thread docs/01-app/02-guides/interactive-apps.mdx Outdated
Comment thread docs/01-app/02-guides/interactive-apps.mdx Outdated
aurorascharff added a commit to aurorascharff/nextjs-app-architecture-skill that referenced this pull request Jun 4, 2026
The guide is not merged yet, so link to vercel/next.js#94020 instead of the
nextjs.org URL which currently 404s.
Comment thread docs/01-app/02-guides/interactive-apps.mdx Outdated
Comment thread docs/01-app/02-guides/interactive-apps.mdx
@icyJoseph

Copy link
Copy Markdown
Member

Looks good to me, there's a few things I want to try out myself after reading the guide, often a good sign!

I am ready to approve the guide, but in terms of discoverability, no other document points to this guide, https://nextjs.org/docs/app/getting-started/mutating-data should point as Next Steps, or in prose somewhere relevant

@aurorascharff aurorascharff requested a review from icyJoseph June 19, 2026 10:26
@aurorascharff aurorascharff merged commit ff43248 into canary Jun 23, 2026
67 checks passed
@aurorascharff aurorascharff deleted the aurorascharff/interactive-apps-guide branch June 23, 2026 13:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

3 participants