feat: nodejs cookbook entry

Author: ysndr

docs/cookbook/languages/nodejs.md

@@ -10,14 +10,43 @@ description: Common questions and solutions for using Node.js with Flox
 Not only can you _develop_ your software with Flox, but you can _build_ it as well.
 See the [builds][build-concept] concept page for more details.
 
-Node.js applications should have their `node_modules` directory placed under
-the `$out/lib` directory.
+### NPM
 
-```toml
+Building Node.js packages with NPM looks similar to building docker containers or serverless functions.
+On a high level, builds for Node.js based projects generally follow this pattern:
+
+```.toml
 [build.myproject]
 command = '''
-  npm install --production --prefix=$out/lib
+# Install dependencies
+npm ci
+
+# Build
+npm run build
+# -> assuming this yields a `dist` directory
+
+# Install the build result to `out` # (1)!
+mkdir -p $out
+mv ./dist $out/
+
+## If your app does not use a bundler
+## and needs additional node_modules at runtime,
+## `npm prune` and copy the node mudules to $out
+#
+# npm prune --include "prod"
+# cp -r ./node_modules $out
+
+# Create a run script if the # (2)!
+mkdir -p $out/bin
+echo "#!/usr/bin/env sh"
+echo 'exec node $out/dist/index.js "$@"' >> $out/bin/myproject
+chmod 755 $out/bin/myproject
 '''
 ```
 
+1. If you expect to install multiple node applications in the same environment, we recommend putting the `dist` (and optinal `node_modules`) under an appropriate namespace, e.g. install them as `/libexec/myproject/dist`.
+
+2. If your `npm build` already produces a binary that can be executed drectly, you can also copy or link that to `$out/bin`. Note that only binaries in `$out/bin` are wrapped to ensure they run within a consistent environment.
+
+
 [build-concept]: ../../concepts/manifest-builds.md