Migrate NuxtHub to Cloudflare Workers

NuxtHub Admin is being sunset on December 31st. This guide covers migrating Nuxt projects from NuxtHub/Pages to Cloudflare Workers.

1. Create Workers Projects

Create Cloudflare Workers projects in the dashboard:

•Production: projectname
•Preview: projectname-preview

2. Configure Nuxt for Cloudflare

Update nuxt.config.ts:

typescript

export default defineNuxtConfig({
  compatibilityDate: "2026-01-26",

  nitro: {
    preset: "cloudflare_module",
    cloudflare: {
      deployConfig: true,
      nodeCompat: true,
    },
  },

  // Remove @nuxthub/core from modules array
})

3. Create wrangler.jsonc

jsonc

{
  "$schema": "node_modules/wrangler/config-schema.json",
  "name": "projectname",
  "account_id": "your-cloudflare-account-id",
  "main": "./.output/server/index.mjs",
  "compatibility_date": "2026-01-26",
  "assets": {
    "directory": "./.output/public/",
    "binding": "ASSETS"
  },
  "observability": {
    "enabled": true
  },
  "vars": {
    "YOUR_ENV_VAR": "value"
  }
}

4. Update package.json

json

{
  "scripts": {
    "deploy": "nuxt build && wrangler deploy",
    "deploy:preview": "nuxt build && wrangler deploy --name projectname-preview"
  }
}

bash

pnpm remove @nuxthub/core
pnpm add -D wrangler

5. Clean up .env

Remove NUXT_HUB_PROJECT_KEY

6. Deploy

bash

pnpm run deploy           # Production
pnpm run deploy:preview   # Preview

7. CI/CD (Workers Builds)

In Cloudflare dashboard: Workers & Pages → Worker → Settings → Builds → Connect

•Build command: pnpm run build
•Deploy command: npx wrangler deploy (or --name projectname-preview for preview)