Dependencies & Install

The TypeScript extension keeps JavaScript and TypeScript dependency setup workspace-native. You should use Putnami dependency commands, not package-manager commands directly.

Install the extension

putnami deps add @putnami/typescript
putnami deps install

putnami deps install installs workspace dependencies and keeps project links consistent with the Putnami graph.

Toolchain

The extension uses:

  • Bun for install, runtime, bundling, tests, and executable compilation
  • Biome for format and lint
  • TypeScript for declaration output

The workspace install phase ensures required TypeScript dev dependencies exist at the workspace root when needed.

When to run install

Run dependency install after:

  • creating a TypeScript project from a template
  • adding or removing a workspace dependency
  • changing extension dependencies
  • pulling a branch that changed the lockfile or workspace package metadata
putnami deps install

Project dependencies

Workspace dependencies should stay visible to Putnami. That lets --impacted select the right build, test, and lint jobs.

Use project references and workspace package metadata rather than hidden local imports. If one project consumes generated assets from another, keep that relationship in the normal workspace dependency graph.