Environment Setup
Install Node.js and pnpm
Node.js runs JavaScript outside the browser, and pnpm manages project dependencies. Both are needed to run the workshop project.
What is Node.js?
Node.js is a program that lets your computer run JavaScript code. Web projects like admin are built with JavaScript, so you need Node.js installed to run them locally.
You will not be writing JavaScript yourself — Node.js works behind the scenes to make everything run.
Install Node.js
Now that you have Homebrew, installing Node.js is a single command:
brew install node
Wait for the installation to complete. You will see output scrolling by — this is normal.
Verify Node.js
Check that Node.js was installed correctly:
node --version
You should see a version number like v22.x.x or similar. Any version 18 or higher will work.
What is pnpm?
pnpm is a package manager. When you download a web project, it usually depends on hundreds of small libraries written by other people. A package manager downloads and organizes all of those libraries for you with a single command.
The admin project uses pnpm (rather than npm or yarn) as its package manager.
Install pnpm
Install pnpm globally using npm (which comes bundled with Node.js):
npm install -g pnpm
The -g flag means "install globally" — it makes pnpm available from anywhere on your computer, not just in one project.
Verify pnpm
Confirm pnpm is installed:
pnpm --version
You should see a version number like 9.x.x or 10.x.x. Any recent version will work.
Both installed?
If both node --version and pnpm --version show version numbers, you are all set. Your environment is ready to run the project.
Restart your terminals
New installs are only visible in the current terminal
When you install tools globally (like Homebrew, Node, and pnpm), only the Terminal session where you ran the install knows about them right away. Any other terminal windows that were already open — including Kiro's built-in terminal — will NOT see the new commands and will show "command not found."
If this happens, close the terminal and reopen it, or run this command to reload your shell session:
exec zsh -l
Remember this tip. If you later open Kiro's terminal and get "command not found" for node, pnpm, or git, this is almost certainly why.