This is an alpha, sneak peek of Monorepo Maestros. For this iteration, I'm getting all of my thoughts down. In the future, we'll have better information architecture, graphics, and other awesomeness. Your feedback is welcome!

Deploy to Vercel

Vercel features built-in CI/CD that can build Turborepo applications with near-zero configuration. To show you how this works, we can deploy two applications to Vercel in under 5 minutes without ever leaving the command line!

Prerequisites

Vercel CLI
A Vercel account (If you don't have one yet, you'll be prompted to create one when you run the CLI for the first time.)
GitHub CLI (Recommended if you don't want to leave your terminal.)
A Github account

Create a new Turborepo

For demo purposes, let's use the Turborepo starter.

npx create-turbo@latest
cd my-turborepo # or whatever name you used

npx create-turbo@latest
cd my-turborepo # or whatever name you used

npx create-turbo@latest
cd my-turborepo # or whatever name you used

npx create-turbo@latest
cd my-turborepo # or whatever name you used

Create a repository on GitHub

In your new repository, make sure you have a remote to commit your code to.

gh repo create --public --source=. --remote=origin

gh repo create --public --source=. --remote=origin

gh repo create --public --source=. --remote=origin

gh repo create --public --source=. --remote=origin

Link your repository to Vercel

Now that your local repository has a remote on GitHub, you can create projects on Vercel that are connected to your remote using Vercel CLI.

vercel link --repo

vercel link --repo

vercel link --repo

vercel link --repo

This command will create a new file at the root of your repository at .vercel/repo.json where you'll find a mapping of your applications to Vercel projects.

Ship!

You're ready to go! Time to ship your applications.

To ship your docs app:

cd apps/docs
vercel

cd apps/docs
vercel

cd apps/docs
vercel

cd apps/docs
vercel

To ship your web app:

cd apps/web
vercel

cd apps/web
vercel

cd apps/web
vercel

cd apps/web
vercel

You've now shipped two preview deployments from one monorepo. You could also choose to run vercel --prod to ship to production.

Vercel will use your Vercel Remote Cache with zero-configuration. Through workspace-level caching, you'll always be shipping as fast as possible.

Iterate!

As you continue building, you can push code to GitHub on branches and pull requests to create new preview deployments and ship code to production. You can also create one-off preview deploymets using vercel in your terminal to ship your current changes to a Preview Deploy whenever you'd like.