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.