Next.js

Deploy Next.js applications to Cloudflare Workers with Alchemy

Deploy Next.js applications to Cloudflare Workers using the OpenNext Cloudflare adapter.

Installation

Install the required dependencies:

npm install alchemy next @opennextjs/cloudflare

Configuration

Configuration Options

Properties

• bindings: Cloudflare bindings (KV, R2, D1, etc.)
• build: Build command override
  • Default: opennextjs-cloudflare build
• dev: Dev command override
  • Default: next dev
• entrypoint: Worker entrypoint path
  • Default: .open-next/worker.js
• assets: Static assets directory
  • Default: .open-next/assets
• noBundle: Skip bundling (useful for debugging)
  • Default: false

Build Configuration

The Next.js resource automatically:

• Runs OpenNext Cloudflare build
• Bundles the worker with minification
• Sets nodejs_compat compatibility flag
• Configures environment variables

Custom Build Command

const website = await Nextjs("website", {
  build: {
    command: "npm run build:cloudflare",
    env: {
      NEXTJS_ENV: "production",
    },
  },
});

Development Server

Customize the development server configuration:

const website = await Nextjs("website", {
  dev: {
    command: "next dev --port 3001",
    domain: "localhost:3001",
    env: {
      NEXTJS_ENV: "development",
    },
  },
});

Start the dev server:

npm run dev

Accessing Bindings

Access Cloudflare bindings in your Next.js app using the platform env:

import { getRequestContext } from '@opennextjs/cloudflare';

export async function GET(request: Request) {
  const { env } = await getRequestContext();
  const db = env.DB;
  const result = await db.prepare("SELECT * FROM users").all();
  
  return Response.json(result);
}

Compatibility Flags

The Next.js resource automatically sets:

• nodejs_compat - Node.js compatibility
• global_fetch_strictly_public - Fetch API compatibility

Add additional flags:

const website = await Nextjs("website", {
  compatibilityFlags: ["streams_enable_constructors"],
});

Limitations

• Not all Next.js features are supported on Cloudflare Workers
• Consult the OpenNext Cloudflare documentation for current limitations
• Some Node.js APIs may not be available

Related Resources

• Website - Base resource for web applications
• Worker - Cloudflare Workers deployment
• D1 Database - SQL database