The Phase Console now natively integrates with Vercel, allowing you to sync secrets and environment variables to your Vercel projects. You can sync secrets to specific environments (Production, Preview, Development) or all environments at once.
Setting up syncing with Vercel
To start syncing secrets to Vercel, you'll need to create an access token from your Vercel account and add it as an authentication mode in Phase Console under Integrations. The access token can be scoped to specific teams or for all projects.
To set up a sync with Vercel, choose an Environment and Path in your Phase App as the source of secrets. Next, select a Vercel project as the destination to sync secrets to. You can choose which Vercel environment(s) to sync with:
- Production: Only sync to production deployments
- Preview: Only sync to preview deployments
- Development: Only sync to development environments
- All: Sync to all environments
Secret Types
When setting up the sync, you can choose how your secrets should be stored in Vercel:
- Plain Text: Values are stored in plain text and visible in the Vercel dashboard. Secrets are only updated when either the key or value changes.
- Encrypted: Values are hidden in the Vercel dashboard but remain accessible. This option triggers a new sync each time as value comparison is not possible.
- Sensitive: Values are never accessible in the Vercel dashboard for maximum security. Like encrypted secrets, this triggers a new sync each time as value comparison is not possible.
The sync will transfer the secret key, value and any comments you've added in Phase to Vercel.
Once setup, Phase will automatically sync your secrets to Vercel whenever you create, update or delete a secret in the selected Environment and path.
You can keep track of sync jobs from the Syncing tab of your App and view detailed logs and metadata for each job. You can also pause and resume a specific sync job if needed, or trigger syncs manually.
You can find complete documentation for setting up and managing Vercel integration in the Phase Docs.
Vercel integration is live on Phase Cloud and available in Phase Console v2.33.0 for self-hosted users.
Reach out on Slack or GitHub for any questions or feedback on this release!