Imagine you have a single code base, which has a few different applications within it... or at least the ability to run a few different applications. Or, maybe you're Google with your mono repo?
In any case, how do you manage this on Heroku? You don't. Heroku applications assume one repo to one application.
Enter the Monorepo buildpack, which is a copy of heroku-buildpack-multi-procfile except it moves the target path in to the root, rather than just the Procfile. This helps for ruby apps etc.
APP_BASE=relative/path/to/app/root, and of course:
heroku buildpacks:add -a <app> https://github.com/lstoll/heroku-buildpack-monorepo
git push email@example.com:<app> master
Note: If you already have other buildpacks defined, you'll need to make sure that the heroku-buildpack-monorepo buildpack is defined first. You can do this by adding
-i 1 to the
heroku buildpacks:add command or changing the buildpack order visually in the application settings under "buildpacks" in the Heroku dashboard.
If you have local dependencies (e.g. a lerna monorepo with
file:../packagename style dependencies pointing to packages contained in the same repo, exactly one level above your package) you can add them using the DEPENDENCIES build var. E.g.
DEPENDENCIES=packages/shared packages/utilto include two packages,
packages/util to one level above the Heroku
BUILD_DIR and make them available for the build process.
Copy the snippet above into CLI.