pnpm run docs:build failing on Ubuntu 24.04 LTS

[adiroiban]

I am trying to get my local dev environment for vitepress.

I followed the contributing guide

This all works

$ pnpm install
$ pnpm run docs

but if I try to build the docs, it fails.

Any idea what I should change... I am using Node 18 from Ubuntu... so maybe I should use a newer NodeJS version.

$ pnpm run docs:build

I get this error

> [email protected] build:prepare /home/adi/chevah/vitepress
> rimraf dist && node scripts/copyShared

node:internal/errors:496
    ErrorCaptureStackTrace(err);
    ^

Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'fs-extra' imported from /home/adi/chevah/vitepress/scripts/copyShared.js
    at new NodeError (node:internal/errors:405:5)
    at packageResolve (node:internal/modules/esm/resolve:916:9)
    at moduleResolve (node:internal/modules/esm/resolve:973:20)
    at defaultResolve (node:internal/modules/esm/resolve:1193:11)
    at ModuleLoader.defaultResolve (node:internal/modules/esm/loader:403:12)
    at ModuleLoader.resolve (node:internal/modules/esm/loader:372:25)
    at ModuleLoader.getModuleJob (node:internal/modules/esm/loader:249:38)
    at ModuleWrap.<anonymous> (node:internal/modules/esm/module_job:76:39)
    at link (node:internal/modules/esm/module_job:75:36) {
  code: 'ERR_MODULE_NOT_FOUND'
}

I tried to install fs-extra ... not sure why it wasn't installed ...

and I ended up with

> [email protected] build:client /home/adi/chevah/vitepress
> vue-tsc --noEmit -p src/client && tsc -p src/client && node scripts/copyClient

/home/adi/chevah/vitepress/node_modules/.pnpm/[email protected]/node_modules/minimatch/dist/commonjs/index.js:7
const brace_expansion_1 = __importDefault(require("brace-expansion"));
                                          ^

Error [ERR_REQUIRE_ESM]: require() of ES Module /home/adi/chevah/vitepress/node_modules/.pnpm/[email protected]/node_modules/brace-expansion/index.js from /home/adi/chevah/vitepress/node_modules/.pnpm/[email protected]/node_modules/minimatch/dist/commonjs/index.js not supported.

[brc-dd]

Hmm, which pnpm version are you using? Run corepack enable it should pick it up. Not sure why fs-extra wasn't installed.

The second error is because minimatch only supports Node 20+. Node 18 is EOL.

[adiroiban]

Sorry for missing that out... I am new to JS programming

$ pnpm --version
10.12.1

[adiroiban]

Thanks. I will get a newer node

[brc-dd]

Hmm, not sure why it skipped fs-extra. Try with newer Node.js once. 22 (latest LTS) preferably.

[adiroiban]

Yes. All good with newest nodejs.

Sorry about that.

I was expecing to see an explicit message that the current version of nodejs is not supported.

But that's ok... these are dev tools, and a dev should know better :p

 $ node --version
v24.2.0