refactor(template): disable global partial prefetching

[laugharn]

What

Flip partialPrefetching from true to false in apps/template/next.config.ts, backing out the partial-prefetch experiment from #322. The key is kept (explicitly false) to document the deliberate choice rather than relying on the implicit default.

-  partialPrefetching: true,
+  partialPrefetching: false,

Why it matters

partialPrefetching is the global default for a route segment's prefetch strategy — but only for segments that don't export their own prefetch. Next resolves it as:

const prefetchConfig = mod.prefetch ?? (partialPrefetching ? 'partial' : undefined)

• With true: segments without a prefetch export default to 'partial', so an in-viewport <Link> (the prefetch: 'auto' default) carries only the per-route App Shell.
• With false: those segments fall back to Next's standard prefetch default (undefined).

Routes that export their own prefetch are unaffected. In this template, app/search/page.tsx is the only such route (prefetch = "allow-runtime"), so it keeps runtime prefetch either way. Home, PDP, collections/[handle], and collections/all currently rely on the global default, so this change moves them off 'partial' back to standard prefetch.

cacheComponents: true stays on (a hard requirement for partialPrefetching when truthy), so this is the only edit needed and partial prerendering (PPR) is untouched — the static-shell routes still report ◐ in the route table.

Validation

• ✅ tsc --noEmit
• ✅ pnpm --filter template lint (oxlint + oxfmt --check)
• Full production build validated by the preview deploy below.

Rollout log

Adds packages/plugin/template-rollout-log/2026-06-22-disable-partial-prefetching.md (defaultAction: review) so downstream storefronts can reason about adopting/skipping the revert. No docs update — partialPrefetching isn't referenced in apps/docs.

Notes

• Rebased onto current main (supersedes the earlier closed refactor(template): disable global partial prefetching #374, which was identical but ~7 commits behind).
• Scoped to the config flag only. The route-level prefetch = "allow-runtime" exports and the dropped prefetch={true} links (refactor(template): drop forced prefetch={true} from product cards and menu links #369) stay as-is — they remain valid; only the global default changes.

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
shop-docs	Ready	Preview, Comment	Jun 24, 2026 12:24pm
shop-template	Ready	Preview, Comment, Open in v0	Jun 24, 2026 12:24pm