cli icon indicating copy to clipboard operation
cli copied to clipboard

Docs: npm global install is unsupported but not documented

Open magentaqin opened this issue 3 months ago • 0 comments

Link Supabase CLI documentation → Node.js installation tab https://supabase.com/docs/guides/local-development/cli/getting-started?queryGroups=platform&platform=npm

Describe the problem The CLI itself throws a clear error when attempting a global npm installation: "Installing Supabase CLI as a global module is not supported." However, the documentation does not mention that: • Global installation via npm install -g supabase is no longer supported • Only npx supabase or installing locally via npm install supabase --save-dev works • Users are expected to use Homebrew, Scoop, or standalone binaries for global usage

This may confuse users coming from older versions of the CLI, where npm -g supabase was previously supported.

Describe the improvement Add a clear note in the Node.js tab such as:

“Global installation using npm install -g supabase is not supported. For global use, please install via Homebrew, Scoop, or the standalone binary.”

Additional context Image

magentaqin avatar Nov 24 '25 20:11 magentaqin