Skip to content

Conversation

@onmax
Copy link
Contributor

@onmax onmax commented Jan 6, 2026

In some discord channels, and also a coworker of mine, have shown some frustation when migrating to NuxtHub.

My coworker specifically said:

The migration of Nuxthub to Cloudflare is weird.
The migration "wizard" of NuxtHub admin says to change the Nitro preset to cloudflare_modulebut that is not mentionend anywhere else in the migration docs. The wrangler config is also different across docs and wizard. How can one even be sure to have the right settings?
And why would we even still need the nuxthub Nuxt module?
And then the docs for installing v10 say one doesn't neven need a wranger.jsonc. https://hub.nuxt.com/docs/getting-started/deploy wtf

I think there is room for improvment and the guide can be clearer

Summary

Clarifies the migration guide to address confusion around wrangler configuration and version scope.

Key improvements:

  • Explicitly states this is v0.9 → v0.10 migration (not v0.5)
  • Highlights v0.10.3+ auto-generates wrangler.json from nuxt.config.ts
  • Restructures Cloudflare section into two clear options:
    • Option A (Recommended): Config in nuxt.config.ts → auto-generated wrangler.json
    • Option B: Manual wrangler.jsonc
  • Updates migration checklist with provider-specific steps
  • Warns migration wizard may show outdated v0.5 instructions

Resolves confusion:

  • "Migration wizard says use cloudflare_module preset" → Now clarified as outdated v0.5 info
  • "Wrangler config different across docs" → Now consistent with deploy.md
  • "Docs say no wrangler.jsonc needed" → Now explicit that it's optional since v0.10.3

@vercel
Copy link

vercel bot commented Jan 6, 2026

@onmax is attempting to deploy a commit to the NuxtLabs Team on Vercel.

A member of the Team first needs to authorize it.

@onmax onmax marked this pull request as ready for review January 6, 2026 18:29
- Add explicit v0.9→v0.10 scope
- Highlight v0.10.3+ auto-generates wrangler.json
- Restructure Cloudflare section: Option A (auto-gen) vs Option B (manual)
- Update checklist with provider-specific steps
- Warn migration wizard may show outdated v0.5 instructions
@onmax onmax force-pushed the docs/clarify-migration-guide branch from dac0503 to 3b90116 Compare January 6, 2026 18:31
@pkg-pr-new
Copy link

pkg-pr-new bot commented Jan 6, 2026

npm i https://pkg.pr.new/@nuxthub/core@770

commit: 3b90116

@atinux atinux merged commit c514f9d into nuxt-hub:main Jan 9, 2026
7 of 9 checks passed
@atinux
Copy link
Contributor

atinux commented Jan 9, 2026

Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants