Mastro

1 Getting Started

Mastro integrates seamlessly with Vercel to provide a complete local-to-production workflow. Once connected, you can deploy your projects directly from the menu bar.

Prerequisites

Mastro installed on your Mac (macOS 13+)
A Vercel account (free or paid)
A Node.js project (Nuxt, Next.js, Vite, etc.)

2 Connect Your Vercel Account

1Open Mastro from your menu bar
2Go to Settings → Integrations
3Click Connect Vercel
4Authorize Mastro in your browser
5You'll be redirected back to Mastro automatically

3 Deploy Your Project

Once connected, deploying is as simple as clicking a button:

1Select your project in Mastro
2Click the Deploy button
3Mastro will create a Vercel project and deploy automatically
4Get your production URL instantly

Permissions

Mastro requests the following permissions from Vercel:

•
Read projects
View your existing Vercel projects
•
Create projects
Create new projects for deployment
•
Create deployments
Deploy your code to Vercel

Troubleshooting

App doesn't open after authorization

Make sure Mastro is running. If the redirect doesn't work, click the "Click here if the app doesn't open" link on the callback page.

Deployment fails

Check that your project has a valid package.json and the correct build configuration. Mastro uses the same build settings as Vercel.

Vercel Integration