@mastra/deployer-vercel

A Vercel deployer for Mastra applications.

Features

• Deploy Mastra applications to Vercel
• Zero-configuration serverless deployments
• Automatic environment variable synchronization
• Support for production, preview, and development environments
• Instant global deployments with Edge Functions

Installation

1pnpm add @mastra/deployer-vercel

Usage

The Vercel deployer is used as part of the Mastra framework:

1import { Mastra } from '@mastra/core';
2import { VercelDeployer } from '@mastra/deployer-vercel';
3
4const deployer = new VercelDeployer({
5  teamSlug: 'your-team-slug',
6  projectName: 'your-project-name',
7  token: 'your-vercel-token',
8});
9
10const mastra = new Mastra({
11  deployer,
12  // ... other Mastra configuration options
13});

Configuration

Constructor Options

• teamSlug (required): Your Vercel team slug
• projectName: Name of your Vercel project (will be created if it doesn't exist)
• token: Your Vercel API token (required for authentication)

Project Structure

The deployer creates:

your-project/
├── vercel.json     # Deployment configuration
└── index.mjs       # Application entry point

vercel.json Configuration

Default configuration:

1{
2  "version": 2,
3  "installCommand": "npm install --omit=dev",
4  "builds": [
5    {
6      "src": "index.mjs",
7      "use": "@vercel/node",
8      "config": {
9        "includeFiles": ["**"]
10      }
11    }
12  ],
13  "routes": [
14    {
15      "src": "/(.*)",
16      "dest": "index.mjs"
17    }
18  ]
19}

Environment Variables

Environment variables are handled automatically through:

• .env files in your project
• Environment variables passed through the Mastra configuration
• Vercel's environment variable UI

Deployment Process

The deployer:

1. Configures your project with the necessary files
2. Deploys to Vercel using the CLI
3. Synchronizes environment variables for future deployments