Skip to main content

Run Node.js in a workspace

This example shows the workspace flow for a Node provider package. Replace the provider reference with the registry namespace and version you publish internally.

Create and populate a workspace​

tinx init app
tinx add core/node as node

If you need to pin a version or registry:

tinx add ghcr.io/acme/node-provider:v20.19.0 as node

Run Node commands​

tinx --workspace app -- node --version
tinx --workspace app -- node build.js
tinx --workspace app exec node --version

If your provider package exposes companion commands through provides, those show up in the same workspace too:

tinx --workspace app -- npm test
tinx --workspace app -- npx eslint .

Use the interactive shell​

tinx --workspace app shell
node --version
npm test

Check the runtime state​

tinx --workspace app ls
tinx --workspace app status --verbose
cat app/.workspace/path

Use this pattern when you want one reproducible Node runtime per workspace instead of relying on the host machine.