Hahn-Solo Product Management
  • Dashboard
  • Technologies
  • Competitors
  • Tasks
Theme
Basic Information
Status
Open
Priority
Next
Category
Bug Fix
Repo
SCB PM
Effort
Trivial
Task ID
T-5394C23B
Details
Deprecate or Archive Pages Router Starter
The `basic-nextjs-pages-router` starter is disabled in `xmcloud.build.json` and uses ESLint 8.x. Next.js Pages Router is not the recommended architecture for XM Cloud. Either formally deprecate it with a notice in its README, move it to a separate archive branch, or remove it entirely. Add a migration pointer to the `basic-nextjs` App Router starter.
Why
A disabled, unmaintained starter in the examples directory creates confusion. New adopters may choose it without realizing it is not the supported path. Content SDK v2.0 targets App Router.
Evidence
`xmcloud.build.json` shows `enabled: false`; starter uses legacy ESLint; Content SDK v2 focuses on App Router
Details
Context: The `basic-nextjs-pages-router` starter has been disabled in `xmcloud.build.json` since at least this inspection period. Next.js Pages Router is not the architecture recommended by Sitecore for XM Cloud development — Content SDK v2.0 is built for App Router with `SitecoreProvider` and hooks patterns. Keeping a disabled, unmaintained starter in the examples directory creates confusion for developers browsing the repo.

Steps:
1. Add a deprecation notice to `examples/basic-nextjs-pages-router/README.md` stating the starter is no longer maintained and pointing to `basic-nextjs` as the recommended alternative.
2. Option A: Move the starter to a `deprecated/` directory. Option B: Remove it entirely and add a note to the repo root README.
3. Update the root README's repository structure section to reflect the change.

Acceptance criteria:
The Pages Router starter either has a clear deprecation notice or is removed
Root README accurately reflects the current starter portfolio
No developer can accidentally choose the Pages Router starter without seeing the deprecation notice

Risks: None identified. The starter is already disabled.
Source Report
reports/product-management/scb/2026-04-05-scb-pm.md
Report date: Apr 5, 2026