> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# BLACKBOX AI Vercel Auto Deploy

> Enable automatic deployment to Vercel directly from Blackbox Cloud tasks, providing a complete end-to-end solution for implementing, testing, and deploying features.

## Overview

BLACKBOX AI Vercel Auto Deploy integrates seamlessly with Vercel to automate the deployment process for your projects. This feature allows you to enable auto-deployment on an individual task level, configure Vercel API tokens, project IDs, and other deployment settings. Once a task is completed, the agent automatically deploys the changes, displays deployment status, and provides a direct link (with a rocket icon) to view the live deployment. It's a complete end-to-end solution where the agent handles implementation, testing, and deployment for you.

<img src="https://mintcdn.com/blackboxai-3b9e98f8/ddHxRamh9ZdA_Bxg/images/blackbox-cloud/cloud_vercel_deploy_status.png?fit=max&auto=format&n=ddHxRamh9ZdA_Bxg&q=85&s=3490fa29bde7176383ffb592a9dbdbfa" alt="Vercel Deploy Status" width="2630" height="1158" data-path="images/blackbox-cloud/cloud_vercel_deploy_status.png" />

This feature streamlines the development workflow by eliminating manual deployment steps, ensuring that code changes are instantly live after task completion.

## Getting Started

To enable Vercel Auto Deploy in Blackbox Cloud, follow these steps:

1. **Access Vercel Settings**\
   Navigate to [cloud.blackbox.ai](https://cloud.blackbox.ai), log in, and go to your task settings. Locate the "Vercel Auto Deploy" section.

   When creating a new task, toggle the Vercel Auto Deploy option to enable automatic deployment for that specific task.

2. **Add Vercel API Token**\
   Generate a Vercel API token from your Vercel dashboard and add it to Blackbox Cloud for deployment access.
   <img src="https://mintcdn.com/blackboxai-3b9e98f8/ddHxRamh9ZdA_Bxg/images/blackbox-cloud/cloud_vercel_enable_auto_deploy.png?fit=max&auto=format&n=ddHxRamh9ZdA_Bxg&q=85&s=dcc5d601ca713e3f134aaa0fbbd6842b" alt="Enable Auto Deploy" width="3224" height="2126" data-path="images/blackbox-cloud/cloud_vercel_enable_auto_deploy.png" />

3. **Configure Project Settings**\
   Set up your Vercel project ID, environment variables, and other deployment configurations.

   <img src="https://mintcdn.com/blackboxai-3b9e98f8/ddHxRamh9ZdA_Bxg/images/blackbox-cloud/cloud_vercel_config_deploy.png?fit=max&auto=format&n=ddHxRamh9ZdA_Bxg&q=85&s=d0002660f59f09c48b8a1c1c363cdf19" alt="Vercel Config Deploy" width="3164" height="2096" data-path="images/blackbox-cloud/cloud_vercel_config_deploy.png" />

   <img src="https://mintcdn.com/blackboxai-3b9e98f8/ddHxRamh9ZdA_Bxg/images/blackbox-cloud/cloud_vercel_setting_general.png?fit=max&auto=format&n=ddHxRamh9ZdA_Bxg&q=85&s=c1d21d2c40e7d890c012825354bb5d4e" alt="Vercel Settings General" width="3178" height="2086" data-path="images/blackbox-cloud/cloud_vercel_setting_general.png" />

   <img src="https://mintcdn.com/blackboxai-3b9e98f8/ddHxRamh9ZdA_Bxg/images/blackbox-cloud/cloud_vercel_setting_env.png?fit=max&auto=format&n=ddHxRamh9ZdA_Bxg&q=85&s=751cedfd46393c45e3c50e60a4d73278" alt="Vercel Settings Environment" width="3182" height="2130" data-path="images/blackbox-cloud/cloud_vercel_setting_env.png" />

   <img src="https://mintcdn.com/blackboxai-3b9e98f8/ddHxRamh9ZdA_Bxg/images/blackbox-cloud/cloud_vercel_build.png?fit=max&auto=format&n=ddHxRamh9ZdA_Bxg&q=85&s=a6b642c24f85f5b277a71000f86296c7" alt="Vercel Build" width="3186" height="2146" data-path="images/blackbox-cloud/cloud_vercel_build.png" />

4. **Start Your Task**\
   Proceed with your task prompt as usual. Once the task is completed, the agent will automatically initiate the deployment process.

With these settings configured, your tasks will now include automatic Vercel deployments upon completion.

## How It Works

Vercel Auto Deploy works by integrating directly with Vercel's API during the task execution lifecycle:

* **Task Completion Trigger**: When a task is marked as complete, the auto-deploy process begins automatically.

* **Deployment Execution**: The agent uses the configured Vercel API token and project settings to trigger a deployment.
  <img src="https://mintcdn.com/blackboxai-3b9e98f8/vmWHa87YhJW9mxJG/images/blackbox-cloud/cloud_vercel_exec_log.png?fit=max&auto=format&n=vmWHa87YhJW9mxJG&q=85&s=427be7e0403f51b7056c592f34eb40eb" alt="Vercel Execution Log" width="2400" height="1072" data-path="images/blackbox-cloud/cloud_vercel_exec_log.png" />

* **Status Monitoring**: Real-time deployment status is displayed in the task logs, showing build progress and any errors.

* **Deployment Link**: Upon successful deployment, a rocket icon link is provided to access the live deployment directly.

* **Error Handling**: If deployment fails, the agent provides detailed error logs for troubleshooting.

This hands-free deployment ensures that your code is live immediately after task completion, without any manual intervention.

## Key Features

* **Task-Level Enablement**: Activate auto-deploy for specific tasks without affecting others.
* **Project Configuration**: Customize deployment settings including project ID, environment variables, and build commands.
* **Real-Time Status Updates**: Monitor deployment progress directly in the task interface.
* **Direct Deployment Links**: Quick access to live deployments via rocket icon links.
* **End-to-End Automation**: Complete solution from implementation to live deployment.

## Benefits

* **Streamlined Workflow**: Eliminate manual deployment steps, allowing focus on development.
* **Instant Deployment**: Code changes go live immediately after task completion.
* **Error Visibility**: Detailed logs for quick identification and resolution of deployment issues.
* **Secure Integration**: API token-based authentication ensures secure deployments.
* **Flexible Configuration**: Customize deployments per task or project needs.
* **Time Savings**: Reduce time spent on deployment processes, accelerating development cycles.

## Use Cases

* **Rapid Prototyping**: Quickly deploy and share prototypes with stakeholders without leaving the development environment.
* **Continuous Integration**: Automate deployments for feature branches, ensuring instant previews.
* **Team Collaboration**: Enable non-technical team members to trigger deployments via task completion.
* **Staging Environments**: Automatically deploy to staging environments for testing before production.
* **Microservices Deployment**: Deploy individual services or components as tasks complete.
* **Documentation Updates**: Auto-deploy static sites or documentation changes instantly.

## Next Steps

Explore related Blackbox Cloud features to enhance your deployment and development capabilities:

<CardGroup>
  <Card title="Blackbox Cloud" icon="cloud" href="./blackbox-cloud">
    Learn about the full remote agent platform.
  </Card>

  <Card title="Multi-Agent Execution" icon="zap" href="./blackbox-cloud-multi-agent">
    Run multiple agents in parallel for complex deployments.
  </Card>

  <Card title="Slack Integration" icon="slack" href="./blackbox-cloud-slack">
    Manage deployments via Slack commands.
  </Card>

  <Card title="Git Integration" icon="git-branch" href="./blackbox-cloud">
    Connect repositories for seamless version control.
  </Card>
</CardGroup>

Vercel Auto Deploy transforms your development workflow into a fully automated pipeline, from code to live deployment.
