Multi-App Repos

A monorepo keeps multiple applications in one repository, with each application in its own subdirectory. Applications can have independent delivery workflows or share a workflow when they must be released together.

Use a parent tenant for the repository and child tenants for individual applications. Configure the hierarchy and repository access in the environments repository as described in Tenancy.

Choose a repository structure before adding application code, Makefiles, and GitHub Actions workflows. For independent releases, each application needs its own workflow, working directory, and version prefix. The repository structure reference includes examples for both independent and shared workflows.

Configure the P2P repository and environment variables for your target environments. Review repository and tenancy changes in PRs before running the delivery workflows.