[{"data":1,"prerenderedAt":45},["ShallowReactive",2],{"\u002Ferrors\u002Fcf-deploy-mode-nuxt":3},{"title":4,"description":5,"path":6,"date":7,"updated":8,"verified":7,"category":9,"keywords":10,"officialSources":16,"related":23,"readingTime":27,"html":28,"toc":29},"cf deploy --mode fails with Nuxt","cf 1.0.0-beta.5 can reject --mode before invoking a detected Nuxt build. The upstream report is open; retaining the working Wrangler deployment is the reported workaround.","\u002Ferrors\u002Fcf-deploy-mode-nuxt","2026-09-29","2026-09-30","Troubleshooting",[11,12,13,14,15],"cf deploy mode nuxt","cf nuxt deploy error","detected command does not support mode","cf deploy --mode nuxt 4","pnpm nuxt build mode error",[17,20],{"label":18,"url":19},"Upstream report: cloudflare\u002Fcf #45","https:\u002F\u002Fgithub.com\u002Fcloudflare\u002Fcf\u002Fissues\u002F45",{"label":21,"url":22},"Framework mode guard in cf build","https:\u002F\u002Fgithub.com\u002Fcloudflare\u002Fcf\u002Fblob\u002Fmain\u002Fpackages\u002Fcli\u002Fsrc\u002Fcommands\u002Fbuild\u002Findex.ts",[24,25,26],"\u002Fcf-deploy","\u002Fcf-vs-wrangler","\u002Fwrangler-to-cf",2,"\u003Ch2 id=\"the-problem\">The problem\u003C\u002Fh2>\n\u003Cp>The upstream report describes a Nuxt 4 project using Nitro’s Cloudflare module preset. Adding \u003Ccode>--mode\u003C\u002Fcode> causes cf to stop before the framework build runs, including when a dry run is requested.\u003C\u002Fp>\n\u003Ch2 id=\"example-error\">Example error\u003C\u002Fh2>\n\u003Cdiv class=\"code-block\">\u003Cdiv class=\"code-toolbar\">\u003Cspan>Error\u003C\u002Fspan>\u003Cbutton type=\"button\" data-copy-code aria-label=\"Copy code\">Copy\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre>\u003Ccode class=\"hljs language-text\">The detected command `pnpm nuxt build` does not currently support `--mode`.\n\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\u003Ch2 id=\"why-it-happens\">Why it happens\u003C\u002Fh2>\n\u003Cp>The current build implementation checks whether the detected framework supports a mode argument. It rejects an explicitly requested mode when that capability is absent. This is a framework delegation limitation, not evidence that the application’s TypeScript configuration is invalid.\u003C\u002Fp>\n\u003Ch2 id=\"current-workaround\">Current workaround\u003C\u002Fh2>\n\u003Cp>The issue author reports keeping deployment on Wrangler with an existing, configured environment:\u003C\u002Fp>\n\u003Cdiv class=\"code-block\">\u003Cdiv class=\"code-toolbar\">\u003Cspan>Terminal\u003C\u002Fspan>\u003Cbutton type=\"button\" data-copy-code aria-label=\"Copy code\">Copy\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre>\u003Ccode class=\"hljs language-bash\">npx wrangler deploy --\u003Cspan class=\"hljs-built_in\">env\u003C\u002Fspan> preview\n\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\u003Cp>This command assumes the project already has a working Wrangler configuration for \u003Ccode>preview\u003C\u002Fcode>. It does not translate a new cf configuration back to Wrangler. Preserve and review that original deployment target before running it.\u003C\u002Fp>\n\u003Cp>Removing \u003Ccode>--mode\u003C\u002Fcode> may change which configuration branch is selected. It is not an equivalent staging workaround. Likewise, \u003Ccode>--prebuilt\u003C\u002Fcode> requires standardized Build Output; ordinary Nitro output alone is insufficient.\u003C\u002Fp>\n\u003Ch2 id=\"status\">Status\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>Open when checked on September 29, 2026.\u003C\u002Fstrong> Source report: \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fcloudflare\u002Fcf\u002Fissues\u002F45\">cloudflare\u002Fcf issue #45\u003C\u002Fa>. This site reviewed the report and the beta build implementation; it has not reproduced a remote Nuxt deployment.\u003C\u002Fp>\n\u003Cp>Check the issue and your installed version again before using this advice. See \u003Ca href=\"\u002Fcf-deploy\">cf deploy\u003C\u002Fa> for Build Output requirements and \u003Ca href=\"\u002Fcf-vs-wrangler\">cf vs Wrangler\u003C\u002Fa> for the transition context.\u003C\u002Fp>\n",[30,33,36,39,42],{"id":31,"text":32},"the-problem","The problem",{"id":34,"text":35},"example-error","Example error",{"id":37,"text":38},"why-it-happens","Why it happens",{"id":40,"text":41},"current-workaround","Current workaround",{"id":43,"text":44},"status","Status",1790729614467]