From cd12a01b309b22d61f8fd169fa30e816eb9fe981 Mon Sep 17 00:00:00 2001
From: Lifei Zhou <lifei@squareup.com>
Date: Thu, 12 Mar 2026 23:12:09 +1100
Subject: [PATCH] doc: Added notes in contribution guide for pnpm (#7833)

---
 CONTRIBUTING.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 7f2f8676ed..8731b1f846 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -43,7 +43,7 @@ If you use Goose, Copilot, Claude, or other AI tools to help with your PRs:
 
 goose includes Rust binaries alongside an electron app for the GUI.
 
-We use [Hermit][hermit] to manage development dependencies (Rust, Node, npm, just, etc.).
+We use [Hermit][hermit] to manage development dependencies (Rust, Node, pnpm, just, etc.).
 Activate Hermit when entering the project:
 
 ```bash
@@ -108,6 +108,12 @@ cargo clippy --all-targets -- -D warnings # run the linter
 
 ### Node
 
+> [!NOTE]
+> This project uses **pnpm** (not npm). If you previously had `node_modules` installed via npm, remove them first:
+> ```bash
+> rm -rf ui/desktop/node_modules
+> ```
+
 To run the app:
 
 ```