From f9b93fcbda9de3f7f9b52f9cf760389dfb9e9530 Mon Sep 17 00:00:00 2001 From: Lokesh Yerneni Date: Mon, 6 Apr 2026 23:45:26 -0700 Subject: [PATCH] docs: add SOP for 'options.recursive' failure occurring in latest Zen installations --- content/docs/contribute/desktop/building.mdx | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/content/docs/contribute/desktop/building.mdx b/content/docs/contribute/desktop/building.mdx index 0f3d6de..64bde2d 100644 --- a/content/docs/contribute/desktop/building.mdx +++ b/content/docs/contribute/desktop/building.mdx @@ -131,6 +131,16 @@ This command launches the browser, allowing you to see your changes in action. ### Common Build Errors & Fixes +#### Q: "The property 'options.recursive' is no longer supported. Received true" error? +> Run: +> ```sh +> brew install node@22 # Install Node 22 +> brew unlink node # Unlink current Node version +> brew link --overwrite node@22 # Link Node 22 +> ``` +> Run `rm -rf /path/to/workspace` to clear your workspace, then restart from [Step 1](https://docs.zen-browser.app/contribute/desktop/building#step-1-getting-started--clone-the-project) + + #### Q: "mach not found" error? > Install [MozillaBuild](https://wiki.mozilla.org/MozillaBuild), add it to your `PATH`, then restart your terminal.