Nuxt

Deploy Nuxt applications to Cloudflare Workers with Alchemy

Deploy Nuxt applications to Cloudflare Workers using the cloudflare-module preset.

Installation

Install the required dependencies:

npm install alchemy nuxt nitro-cloudflare-dev

Configuration

Configuration Options

Properties

• bindings: Cloudflare bindings (KV, R2, D1, etc.)
• build: Build command override
  • Default: nuxt build
• dev: Dev command override
  • Default: nuxt dev
• entrypoint: Worker entrypoint path
  • Default: .output/server/index.mjs
• assets: Static assets directory
  • Default: .output/public
• noBundle: Skip bundling
  • Default: true

Accessing Bindings

Access Cloudflare bindings in your Nuxt application:

export default defineEventHandler(async (event) => {
  const db = event.context.cloudflare.env.DB;
  const result = await db.prepare("SELECT * FROM users").all();
  
  return result.results;
});

Local Development

The nitro-cloudflare-dev module provides:

• Local emulation of Cloudflare bindings
• Hot module replacement
• Development server with platform context

Start the dev server:

npm run dev

Node.js Compatibility

The Nuxt resource automatically sets compatibility: "node" for Node.js API support.

This enables:

• Node.js built-in modules
• npm packages that depend on Node.js APIs
• Full Nuxt feature set

Build Optimization

Customize the build process:

const website = await Nuxt("website", {
  build: {
    command: "nuxt build --preset cloudflare_module",
    env: {
      NODE_ENV: "production",
    },
  },
});

Server Routes

Create server API routes in server/api/:

// server/api/users.ts
export default defineEventHandler(async (event) => {
  const { DB } = event.context.cloudflare.env;
  const users = await DB.prepare("SELECT * FROM users").all();
  return users.results;
});

Deployment Best Practices

• Use environment variables for secrets
• Configure bindings in alchemy.run.ts
• Test locally with nitro-cloudflare-dev
• Keep .output directory in .gitignore

Related Resources

• Website - Base resource for web applications
• D1 Database - SQL database
• KV Namespace - Key-value storage