Hey there,

You're correct about the workflow when using Turborepo with environment variables on Vercel. The three steps you described are indeed the standard approach:

1. Create environment variables in the Vercel dashboard
2. Run vercel env pull to get them locally
3. Add the environment variables to your turbo.json configuration

This is intentional and documented in Vercel's guidelines for deploying Turborepo projects . The reason for this additional step is that Turborepo needs to know about environment variables for proper caching behavior:

"It's important to ensure you are managing environment variables correctly. If your project has environment variables, you'll need to create a list of them in your turbo.json so Turborepo knows to use different caches for different environments."

Without declaring them in turbo.json, you could accidentally ship your staging environment to production if Turborepo doesn't know that certain environment variables affect the build output .

You can declare environment variables in your Turborepo configuration in a few ways:

1
{
2
  "pipeline": {
3
    "build": {
4
      "env": [
5
        "SPECIFIC_ENV_VAR"
6
      ]
7
    }
8
  },
9
  "globalEnv": [
10
    "GITHUB_TOKEN" // affects all tasks
11
  ]
12
}

Your suggestion about having the Vercel CLI automatically add environment variables to the Turborepo config is interesting and would improve the developer experience. I will share this feedback internally! :)

Thanks for the reply. Yes, please share it internally. It would be awesome to see this feature.