Contributing¶

Scope¶

Nexus currently accepts contributions focused on:

• packages/nexus
• packages/sdk/js

Setup¶

git clone https://github.com/YOUR-USERNAME/nexus
cd nexus
pnpm install

Build and test¶

task build
task test

Direct commands:

cd packages/nexus && go test ./...
cd packages/sdk/js && pnpm exec tsc --noEmit && pnpm exec jest --runInBand

Documentation¶

Update docs when behavior changes:

• docs/reference/workspace-daemon.md
• docs/reference/workspace-sdk.md
• docs/reference/workspace-config.md

Commit style¶

Use Conventional Commits.

Examples:

• feat(workspace-daemon): add compose port auto-forward
• fix(workspace-sdk): align spotlight response types
• docs: update workspace config reference