go-admingo-admin
  • Guide
  • Development
    • Advanced
    • Commands
  • Advanced
  • Help
  • GitHub
  • Changelog
⌘ K
Introduction
Quick Start
Go Environment
Go Modules
Environment Variables
Node Environment
IDE Setup
Conventions
Deployment
FAQ
Last updated:
Open-source MIT Licensed | Copyright © 2020-present
Powered by go-admin-team

TABLE OF CONTENTS

‌
‌
‌
‌

WARNING

This section covers installing the Node.js and pnpm that go-admin-ui needs, for readers setting up the frontend environment for the first time.

Readers who already have Node set up can go straight to Quick Start.

Installing Node.js & npm

Download

Official download page: https://nodejs.org/en/download/ — pick the build for your OS; an LTS release is recommended.

WARNING

go-admin-ui requires Node 22 or later (see the engines field in package.json). Node 14 / 16 / 18 / 20 have all reached end of life, and Vite 8, the build tool used here, doesn't run on them.

nodejs-down

Install

Double-click the downloaded installer and follow the steps:

nodejs-step1nodejs-step2nodejs-step3nodejs-step4nodejs-step5

Once installed, node and npm land under /usr/local/bin/ (the screenshots above are from an older installer; the UI and version number you see may differ — follow whatever your installer actually shows).

That's it — Node.js and npm are installed.

Verify

Check the Node.js version:

sh
$  node -v
v22.14.0

Anything v22 or later means the Node.js environment is good to go.

Installing pnpm

go-admin-ui manages dependencies with pnpm, and pnpm-lock.yaml is committed to the repository. Installing with npm or yarn ignores that lockfile and may pull dependency versions that don't match CI.

sh
# option 1: install via npm
$ npm install -g pnpm


# option 2: use Node's built-in corepack (no extra download needed)
$ corepack enable

Verify:

sh
$  pnpm -v
9.15.1

Anything 9 or later is fine.

WARNING

Where to get help: If anything in this guide is unclear, please open an issue.