next.js

db0fdc30 - docs(cli): clarify that `--debug-build-paths` requires route group folders in paths (#92618)

docs(cli): clarify that `--debug-build-paths` requires route group folders in paths (#92618) <!-- CURSOR_AGENT_PR_BODY_BEGIN --> ### What? Adds a note to the `--debug-build-paths` section of the CLI docs clarifying that [route groups](https://nextjs.org/docs/app/building-your-application/routing/route-groups) must be included in file paths. ### Why? When using `--debug-build-paths`, users need to include route group folders (e.g., `(marketing)`) in the file paths they pass. This isn't obvious from the existing documentation — route groups are stripped from URLs at runtime but must be present in file paths for this CLI option to work correctly. Addresses feedback from a docs comment noting that "Route groups are also necessary, should be inferred from file paths, but it is not straightforward from reading this." ### How? Added a "Good to know" callout with an example showing how to reference a page inside a route group: ```bash next build --debug-build-paths="app/(marketing)/about/page.tsx" ``` <!-- NEXT_JS_LLM_PR --> <!-- CURSOR_AGENT_PR_BODY_END --> [Slack Thread](https://vercel.slack.com/archives/C07ND110MMF/p1775828588791049?thread_ts=1775828588.791049&cid=C07ND110MMF) <div><a href="https://cursor.com/agents/bc-3a58eac7-35a3-56ab-aff2-f4cf2dd1ca9b"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-web-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-web-light.png"><img alt="Open in Web" width="114" height="28" src="https://cursor.com/assets/images/open-in-web-dark.png"></picture></a>&nbsp;<a href="https://cursor.com/background-agent?bcId=bc-3a58eac7-35a3-56ab-aff2-f4cf2dd1ca9b"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-cursor-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-cursor-light.png"><img alt="Open in Cursor" width="131" height="28" src="https://cursor.com/assets/images/open-in-cursor-dark.png"></picture></a>&nbsp;</div> --------- Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: Joseph <icyJoseph@users.noreply.github.com>