Support Next.js in autoconfig and also delegate to open-next for `wrangler deploy` runs executed in open-next projects #11301

dario-piotrowicz · 2025-11-16T17:57:55Z

Fixes https://jira.cfdata.org/browse/DEVX-2321

Tests
- Tests included
- Tests not necessary because:
Public documentation
- Cloudflare docs PR(s):
- Documentation not necessary because: tracked elsewhere
Wrangler V3 Backport
- Wrangler PR:
- Not necessary because: not in v3

changeset-bot · 2025-11-16T17:57:58Z

🦋 Changeset detected

Latest commit: 38859dc

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

pkg-pr-new · 2025-11-16T18:16:35Z

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@11301

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@11301

miniflare

npm i https://pkg.pr.new/miniflare@11301

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@11301

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@11301

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@11301

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@11301

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@11301

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@11301

wrangler

npm i https://pkg.pr.new/wrangler@11301

commit: b88b00f

packages/wrangler/src/autoconfig/frameworks/next.ts

dario-piotrowicz · 2025-11-17T16:25:48Z

Converting to draft since the C3 e2es don't currently run in CI and we should enable them before merging and new C3 autoconfig PR

ascorbic · 2025-11-19T17:44:25Z

When I tried this locally, with a new project, I got "✘ [ERROR] The entry-point file at ".open-next/worker.js" was not found.". I needed to do another npm run deploy manually

ascorbic · 2025-11-20T11:39:35Z

The issue is that it doesn't run opennextjs-cloudflare build. I'm not sure what the best workaround is here.

ascorbic · 2025-11-20T11:40:26Z

Should it change the build command?

dario-piotrowicz · 2025-11-27T18:13:48Z

Should it change the build command?

oh... yeah I see the issue.... that's annoying.... I don't think we could change the build command since that's for example used by the Vercel CLI and changing it can have some unexpected consequences... 🤔 I think we should ideally let wrangler deploy know the build command that it needs to run? 🤔

dario-piotrowicz · 2025-11-27T18:44:16Z

@ascorbic WDYT?

0927724

ascorbic · 2025-11-28T11:20:10Z

0927724

I think these changes should be in a separate PR. Will they then override the package.json build command too?

packages/wrangler/src/deploy/index.ts

packages/wrangler/src/deploy/open-next.ts

penalosa · 2025-12-11T14:56:27Z

packages/wrangler/src/deploy/open-next.ts

+ * Checks whether a project is an OpenNext one and in such case delegates the deployment to `@opennextjs/cloudflare`.
+ * If the project is not an OpenNext one, or the `OPEN_NEXT_DEPLOY` environment variable is set (meaning that `wrangler
+ * deploy` has been called from OpenNext itself), then no delegation happens.
+ *
+ * Why?
+ *  `wrangler deploy` shouldn't be run on an open-next project, since open-next has its own deploy command,
+ *  in the interest in having things "just work" we updated `wrangler deploy` to delegate to the open-next
+ *  deploy command, so that, if a developer runs `npx wrangler deploy` (e.g. like in Workers Builds) on an
+ *  open-next project that will work just fine.
+ *
+ * @param projectRoot The path to the project's root
+ * @returns true is the deployment has been delegated to open-next, false otherwise


This is very verbose. Can we simplify to make it clearer what's going on here?

I've simplified this comment: 38859dc

please let me know what you think

penalosa · 2025-12-11T14:58:51Z

packages/wrangler/src/autoconfig/git.ts

+	}
+}
+
+export async function appendToGitIgnore(


This doesn't do quite the same thing as the existing functions, which check to make sure we're not adding something to the gitignore twice. Is there a reason we no longer need to check that?

If you see the TODO comment I've added at the top of the file I do think that there's some cleanup to do here and code to consolidate 👍

Specifically in regards of the check here, I skipped it to keep things simple, I can add one but I am just using this function for open-next, there I think we'll always end up adding this section anyways because if .open-next as already in the gitignore file then open-next was already being used by the project, but in that case then the app wouldn't require the auto-configuration.

Co-authored-by: Somhairle MacLeòid <[email protected]>

…rror`

…mmary

Co-authored-by: Somhairle MacLeòid <[email protected]>

workers-devprod added this to workers-sdk Nov 16, 2025

github-project-automation bot moved this to Untriaged in workers-sdk Nov 16, 2025

dario-piotrowicz force-pushed the dario/DEVX-2321/autoconfig-nextjs branch from e1a384a to 31e5296 Compare November 16, 2025 18:13

dario-piotrowicz force-pushed the dario/DEVX-2321/autoconfig-nextjs branch from 31e5296 to 20d1242 Compare November 16, 2025 18:49

vicb reviewed Nov 16, 2025

View reviewed changes

packages/wrangler/src/autoconfig/frameworks/next.ts Outdated Show resolved Hide resolved

vicb reviewed Nov 16, 2025

View reviewed changes

packages/wrangler/src/autoconfig/frameworks/next.ts Outdated Show resolved Hide resolved

vicb reviewed Nov 16, 2025

View reviewed changes

packages/wrangler/src/autoconfig/frameworks/next.ts Outdated Show resolved Hide resolved

dario-piotrowicz force-pushed the dario/DEVX-2321/autoconfig-nextjs branch from 20d1242 to a2f24b5 Compare November 17, 2025 10:37

dario-piotrowicz requested a review from vicb November 17, 2025 10:38

dario-piotrowicz force-pushed the penalosa/autoconfig-sveltekit branch from b1d0f1b to ba94707 Compare November 17, 2025 11:27

dario-piotrowicz force-pushed the dario/DEVX-2321/autoconfig-nextjs branch from a2f24b5 to a087f96 Compare November 17, 2025 11:28

Base automatically changed from penalosa/autoconfig-sveltekit to main November 17, 2025 14:06

dario-piotrowicz force-pushed the dario/DEVX-2321/autoconfig-nextjs branch from a087f96 to db411f0 Compare November 17, 2025 14:09

dario-piotrowicz marked this pull request as ready for review November 17, 2025 14:09

dario-piotrowicz requested a review from a team as a code owner November 17, 2025 14:09

dario-piotrowicz marked this pull request as draft November 17, 2025 16:25

dario-piotrowicz force-pushed the dario/DEVX-2321/autoconfig-nextjs branch from db411f0 to 9845bde Compare November 17, 2025 23:07

dario-piotrowicz marked this pull request as ready for review November 18, 2025 17:30

dario-piotrowicz force-pushed the dario/DEVX-2321/autoconfig-nextjs branch 2 times, most recently from 69a48af to 73871b5 Compare November 27, 2025 11:28

dario-piotrowicz force-pushed the dario/DEVX-2321/autoconfig-nextjs branch from 73871b5 to 0927724 Compare November 27, 2025 18:43

ascorbic approved these changes Dec 10, 2025

View reviewed changes

dario-piotrowicz force-pushed the dario/DEVX-2321/autoconfig-nextjs branch 2 times, most recently from 0d9a598 to b88b00f Compare December 10, 2025 12:26

penalosa reviewed Dec 11, 2025

View reviewed changes

dario-piotrowicz requested review from a team as code owners December 11, 2025 17:23

dario-piotrowicz and others added 14 commits December 11, 2025 17:25

Support Next.js in autoconfig

c5514b8

Update packages/wrangler/src/autoconfig/frameworks/next.ts

ce05db7

Co-authored-by: Somhairle MacLeòid <[email protected]>

update AutoConfigFrameworkConfigurationError class to extend `UserE…

8b6630c

…rror`

add WORKER_SELF_REFERENCE service config

09aee98

delegate deploy to open-next for open-next projects

e0bcd1b

move next to the right framework position

7bdfa3c

move scripts to packageJsonScriptsOverrides

fb51cda

fix packageJsonScriptsOverrides not being passed to buildOperationsSu…

b5aff98

…mmary

add OpenNext to changesets

d6178d6

improve jsdoc comment for maybeDelegateToOpenNextDeployCommand

ca00bee

update OpenNext log

08b9f02

test whole std with single toMatchInlineSnapshot

b730789

rename probeForNextConfigPath to findNextConfigPath

0467a30

Update packages/wrangler/src/deploy/open-next.ts

3e2729c

Co-authored-by: Somhairle MacLeòid <[email protected]>

dario-piotrowicz force-pushed the dario/DEVX-2321/autoconfig-nextjs branch from 541281c to 3e2729c Compare December 11, 2025 17:25

dario-piotrowicz added 3 commits December 11, 2025 17:26

move OPEN_NEXT_DEPLOY to misc-variables

1845999

move openNext delegation after autoconfig logic

94d3d91

simplify comment

38859dc

dario-piotrowicz merged commit 6c590a0 into main Dec 15, 2025
33 checks passed

dario-piotrowicz deleted the dario/DEVX-2321/autoconfig-nextjs branch December 15, 2025 11:32

github-project-automation bot moved this from Approved to Done in workers-sdk Dec 15, 2025

workers-devprod mentioned this pull request Dec 15, 2025

Version Packages #11602

Open

lrapoport-cf mentioned this pull request Dec 16, 2025

Update fair-words-repair.md #11659

Open

6 tasks

Support Next.js in autoconfig and also delegate to open-next for wrangler deploy runs executed in open-next projects #11301

Support Next.js in autoconfig and also delegate to open-next for wrangler deploy runs executed in open-next projects #11301

Uh oh!

Conversation

dario-piotrowicz commented Nov 16, 2025

Uh oh!

changeset-bot bot commented Nov 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

pkg-pr-new bot commented Nov 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

dario-piotrowicz commented Nov 17, 2025

Uh oh!

ascorbic commented Nov 19, 2025

Uh oh!

ascorbic commented Nov 20, 2025

Uh oh!

ascorbic commented Nov 20, 2025

Uh oh!

dario-piotrowicz commented Nov 27, 2025

Uh oh!

dario-piotrowicz commented Nov 27, 2025

Uh oh!

ascorbic commented Nov 28, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

penalosa Dec 11, 2025

Choose a reason for hiding this comment

Uh oh!

dario-piotrowicz Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

penalosa Dec 11, 2025

Choose a reason for hiding this comment

Uh oh!

dario-piotrowicz Dec 11, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Support Next.js in autoconfig and also delegate to open-next for `wrangler deploy` runs executed in open-next projects #11301

Support Next.js in autoconfig and also delegate to open-next for `wrangler deploy` runs executed in open-next projects #11301

changeset-bot bot commented Nov 16, 2025 •

edited

Loading

pkg-pr-new bot commented Nov 16, 2025 •

edited

Loading