Nuxt

In this guide, you will create a new Nuxt ↗ application and deploy to Cloudflare Workers (with the new Workers Assets).

Already have a Nuxt project?

Run wrangler deploy in a project without a Wrangler configuration file and Wrangler will automatically detect Nuxt, generate the necessary configuration, and deploy your project.

npm yarn pnpm

npx wrangler deploy

yarn wrangler deploy

pnpm wrangler deploy

Learn more about automatic project configuration.

Nuxt Detected

Generated configuration

wrangler.jsonc

main: .output/server/index.mjs

wrangler.jsonc

assets: directory: .output/public

wrangler.jsonc

compatibility_flags: nodejs_compat

wrangler.jsonc

observability: enabled: true

nuxt.config.ts

preset: cloudflare

Workers Deployed

Wrangler handles configuration automatically

1. Set up a new project

Use the create-cloudflare ↗ CLI (C3) to set up a new project. C3 will create a new project directory, initiate Nuxt's official setup tool, and provide the option to deploy instantly.

To use create-cloudflare to create a new Nuxt project with Workers Assets, run the following command:

npm yarn pnpm

npm create cloudflare@latest -- my-nuxt-app --framework=nuxt

yarn create cloudflare my-nuxt-app --framework=nuxt

pnpm create cloudflare@latest my-nuxt-app --framework=nuxt

After setting up your project, change your directory by running the following command:

cd my-nuxt-app

2. Develop locally

After you have created your project, run the following command in the project directory to start a local server. This will allow you to preview your project locally during development.

npm yarn pnpm

npm run dev

yarn run dev

pnpm run dev

3. Deploy your Project

Your project can be deployed to a *.workers.dev subdomain or a Custom Domain, from your own machine or from any CI/CD system, including Cloudflare's own.

The following command will build and deploy your project. If you're using CI, ensure you update your "deploy command" configuration appropriately.

npm yarn pnpm

npm run deploy

yarn run deploy

pnpm run deploy

---

Bindings

Your Nuxt application can be fully integrated with the Cloudflare Developer Platform, in both local development and in production, by using product bindings. The Nuxt documentation ↗ provides information about configuring bindings and how you can access them in your Nuxt event handlers.

With bindings, your application can be fully integrated with the Cloudflare Developer Platform, giving you access to compute, storage, AI and more.

Bindings Access to compute, storage, AI and more.