Skip to content
← Back to Blog

Friday, August 28th 2020

Company News

Friday, August 28th 2020

Monorepos

Posted by

Avatar for shuding

Shu Ding

@shuding_

Avatar for igor

Igor Klopov

@iklopov

Avatar for styfle

Steven

@styfle

Avatar for javivelasco

Javi Velasco

@javivelasco

Avatar for skllcrn

Christopher Skillicorn

@skllcrn

Avatar for leo

Leo Lamprecht

@notquiteleo

Vercel now supports monorepos for improved flexibility at scale. From the same Git repository, you can set up multiple projects to be built and deployed in parallel.

Monorepos let your team use multiple programming languages and frameworks, collaborate better, and leverage microfrontend architectures.

Learn more about how monoreops are changing how teams build software.

The architecture of a monorepo deployed to Vercel.
The architecture of a monorepo deployed to Vercel.
The architecture of a monorepo deployed to Vercel.
The architecture of a monorepo deployed to Vercel.

Creating Projects from a Monorepo

To connect multiple Vercel projects with the same Git repository, create a new project for each of the directories within the Git repository:

Creating a new Vercel project for a directory within a monorepo.
Creating a new Vercel project for a directory within a monorepo.

Repeat this process for each app you want to set up. Your plan determines how many Vercel projects can be connected with the same Git repository:

  • 3 for Hobby (Personal Accounts)
  • 10 for Pro (Teams)
  • Custom for Enterprise (Teams) – Contact Sales

If needed, you can even use the same Root Directory for multiple projects.

Deploying from a Monorepo

Once your monorepo is set up, push changes to your Git repository as usual and you'll see the commits deployed to the Vercel projects you've connected.

For the best performance, Deployments are built in parallel.

An example of Deployment URLs provided by a Git Integration.
An example of Deployment URLs provided by a Git Integration.
An example of Deployment URLs provided by a Git Integration.
An example of Deployment URLs provided by a Git Integration.

Ignoring the Build Step

Pushing a commit to your monorepo will create a Deployment for each of the connected projects.

If you want to abort the Build Step for certain projects if their files didn't change, you can now do so with the Ignored Build Step section in Git Integration page of the project settings:

Setting a command for ignoring the Build Step.
Setting a command for ignoring the Build Step.

Learn more about ignoring the Build Step in the documentation.

Conclusion

You can now connect multiple Vercel projects to the same Git repository, using GitHub, GitLab, or Bitbucket by following our documentation.

We will continue to expand our monorepo support with more options and capabilities. Let us know your feedback and what you'd like to see next.

Develop.
Preview.
Ship.

The development platform for the best frontend teams.