cli icon indicating copy to clipboard operation
cli copied to clipboard

Add minimum Node.js version requirement to CLI docs (Node 16 fails)

Open magentaqin opened this issue 3 months ago • 2 comments

Link Supabase CLI documentation → Node.js installation tab

Describe the problem The Node.js installation tab suggests running: npx supabase --help However, the page does not specify the minimum required Node.js version.

On my machine with Node 16, running npx supabase results in runtime errors and the CLI fails to start.

The CLI only works correctly starting from Node 20+.

This can confuse new users and create onboarding friction, as the Node.js tab seems to imply that the CLI will run on any Node environment.

Describe the improvement Add a clear note to the Node.js section, such as: “Supabase CLI requires Node.js 20+ or higher when used via npx.”

Or display a version requirement badge on the tab.

Additional context Trying to install [email protected] Image

magentaqin avatar Nov 22 '25 15:11 magentaqin

Hi @magentaqin, thank you for the feedback and suggestion. Since our docs page is open source, would you like to open a PR to update it? I'm happy to approve so feel free to tag me.

sweatybridge avatar Nov 27 '25 08:11 sweatybridge

Hi @magentaqin, thank you for the feedback and suggestion. Since our docs page is open source, would you like to open a PR to update it? I'm happy to approve so feel free to tag me.

Sure!

magentaqin avatar Nov 27 '25 13:11 magentaqin