Documentation navigation
Anybuild documentation

Workspaces and Subdirectories

Build one application inside a larger repository without losing workspace context.

Select an application

Terminal
anybuild . --subdir apps/web --start

Definition and state

A subdirectory such as apps/web generates Anybuild.apps-web at the workspace root. The file records app_subdir = "apps/web", and state is isolated under .anybuild/apps-web.

Node.js package managers

If a Node.js subdirectory has no lockfile of its own, Anybuild inherits the workspace root's detected package manager and rewrites package-manager-prefixed build commands when needed.

Path safety

The subdirectory must be relative, must exist, must be a directory, and must remain inside the workspace root.