Request for Setup Instructions

[lovelindhoni]

Could someone please provide detailed instructions on how to set up the environment and start hacking on the site locally?
Any guidance would be greatly appreciated.

@kgryte @Planeshifter

[kgryte]

I suggest exploring the repo: https://github.com/stdlib-js/www/blob/master/docs/build.md

[lovelindhoni]

I set it up just as directed in the build instructions above, but for some reason, I can't build api-docs-app (using make api-docs-app).

Setting NODE_PATH to resolve modules absolutely has been deprecated in favor of setting baseUrl in jsconfig.json (or tsconfig.json if you are using TypeScript) and will be removed in a future major release of create-react-app.

Creating an optimized production build...
Error parsing bundle asset "/home/lovelindhoni/dev/projects/www/public/docs/api/static/js/2.e5556929.chunk.js": no such file
Error parsing bundle asset "/home/lovelindhoni/dev/projects/www/public/docs/api/static/js/main.9ba952b5.chunk.js": no such file
Error parsing bundle asset "/home/lovelindhoni/dev/projects/www/public/docs/api/static/js/runtime-main.e47de42b.js": no such file

No bundles were parsed. Analyzer will show only original module sizes from stats file.

Webpack Bundle Analyzer saved report to /home/lovelindhoni/dev/projects/www/build/bundle_report.html
Failed to compile.

Failed to minify the bundle. Error: static/js/main.9ba952b5.chunk.js from Terser
Error: error:0308010C:digital envelope routines::unsupported
    at Array.forEach (<anonymous>)
    at /home/lovelindhoni/dev/projects/www/tools/scripts/api-docs/app.js:152:19
    at finalCallback (/home/lovelindhoni/dev/projects/www/node_modules/webpack/lib/Compiler.js:257:39)
    at /home/lovelindhoni/dev/projects/www/node_modules/webpack/lib/Compiler.js:273:13
    at eval (eval at create (/home/lovelindhoni/dev/projects/www/node_modules/tapable/lib/HookCodeFactory.js:33:10), <anonymous>:11:1)
    at Immediate.<anonymous> (/home/lovelindhoni/dev/projects/www/node_modules/webpack-bundle-analyzer/lib/BundleAnalyzerPlugin.js:75:13)
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
Read more here: https://bit.ly/CRA-build-minify

make: *** [/home/lovelindhoni/dev/projects/www/tools/make/lib/docs/app.mk:34: api-docs-app] Error 1

[kgryte]

What version of Node.js and npm are you using?

[kgryte]

...and what happens when you just run

make build

?

[lovelindhoni]

Everything works fine when I downgraded my node version from 20.11.1 to 16.20.2 (lts/gallium) :)

[kgryte]

Hmm...interesting. Thanks for that info.

cc @Planeshifter

[krishnaagrawal7508]

I set it up just as directed in the build instructions above, but for some reason, when I run make (make build) then no response is shown...

[kgryte]

You can try running the various steps executed by make build individually. You can find those in the make files present in this repo.

[gcbibek3353]

@kgryte I tried to set up the project locally by following www/docs/build.md file instructions.
I am getting this error on executing
make build and npm run start
can you help me with this issue ?

[kgryte]

@gcbibek3353 Did you run make install beforehand?

[Girish-Garg]

I have checked whole @stdlib in node_modules and unable to fine _tools which is causing error i think
fs/exists and process/cwd exists but _tools/docs/www/benchmark-bundles is not even installing from npm separately

make build calls pkg-benchmarks, pkg-tests and pkg-html which require this _tools ultimately causing error

[kgryte]

First run

make install

then check the root node_modules directory in the cloned www repository on your local machine. You should see a @stdlib/stdlib package installed. If you do not, something is messing up with the clone command (see https://github.com/stdlib-js/www/blob/master/tools/make/lib/install/node.mk#L41).

If it is there, it is possible that the NODE_PATH environment variable is not being handled correctly. If so, what is your Node version and npm version?

[Girish-Garg]

@kgryte did the whole make install again and got all the @stdlib/_tools now but there is still some error with build function as it is causing in sleep which i conformed after running process status command --->

node --> v22.14.0 (lts/jod)
npm --> 11.2.0