Monorepo support

If your project lives in a subdirectory of a larger repository, set a root directory to tell Velumi where to find it. Velumi will then run the build from that subdirectory.

Setting the root directory

During project creation or when editing the source, there is a Root directory field below the repo/branch/commit selector. Enter the path relative to the repository root — for example:

apps/web
packages/frontend
services/api

Leave it empty to build from the repository root.

Archive projects

The root directory field is not available for archive upload projects. Structure your archive so the build root is at the top level of the archive, or adjust your build command to change into the relevant directory.

Environment-level overrides

The root directory is part of the project's default source and cannot be overridden per environment. If you need different root directories per environment, create separate projects.