Project graph

Nx Forge extends the Nx project graph to teach Nx about Forge applications and their dependencies.

Forge application projects

Nx Forge inspects all project in an Nx workspace and infers any project with a manifest.yml file in the project root as a Forge application project.

Resource dependencies

For each Forge application project, Nx Forge inspects the resources declared in the manifest.yml and expects the path parameter of the resource declaration to point to a project name in the Nx workspace. It then registers those project dependencies with the Nx project graph.

The result is that Nx now knows which other projects in a workspace a Forge application depends on. Nx can then run dependent tasks (such as build) on dependent projects before running them on a particular Forge application.

Additionally, because the Nx Forge plugin knows its resource dependencies, it automatically copies the dependent resource project artifacts into the Forge app output directory at build time. It also patches the Nx project reference in the manifest file with the actual path pointing to the copied resource artifacts, producing a deployable Forge application.