Skip to content

Install Nx Cloudflare

  • Node.js 22 or later — an active LTS release. Required by Nx and Wrangler.
  • An existing Nx workspace. If you don’t have one, create it with bunx create-nx-workspace@latest.
  • A package manager: bun, npm, yarn, or pnpm. Examples below use bunx.
  1. Add the plugin

    The recommended way is nx add, which installs the package and runs the init generator to set up workspace-level dependencies and register the inference plugin:

    bunx nx add @naxodev/nx-cloudflare

    This installs Wrangler v4, @cloudflare/workers-types, and Vitest as devDependencies, and adds @naxodev/nx-cloudflare/plugin to the plugins array in nx.json so Worker targets are inferred automatically.

  2. (Alternative) Install manually

    If you prefer to control setup yourself, install the package and Wrangler separately, then register the plugin in nx.json:

    bun add -D @naxodev/nx-cloudflare wrangler

    Then add the plugin to nx.json:

    {
      "plugins": ["@naxodev/nx-cloudflare/plugin"]
    }

    See Plugin options for the object form if you need to customize inferred target names.

  3. Verify the plugin is registered

    Confirm Nx recognizes the plugin by refreshing the project graph and inspecting a Worker project (once you have one):

    bunx nx reset
    bunx nx show project <my-worker>

    The output should list serve, deploy, typegen, version-upload, version-deploy, tail, secret, and version-secret targets (plus a d1 target if the project’s Wrangler config declares D1 databases). If you don’t have a Worker yet, the Quick start walks through generating one.