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

# Deployment Overview

> Deploy your VibeHub projects to the web

## Overview

VibeHub integrates with popular deployment platforms so you can ship your projects with a single click. Connect to Netlify or Vercel and deploy directly from your project dashboard.

## Supported Platforms

<CardGroup cols={2}>
  <Card title="Netlify" icon="n" href="/deployment/connecting-netlify">
    Deploy static sites, serverless functions, and full-stack applications
  </Card>

  <Card title="Vercel" icon="triangle" href="/deployment/connecting-vercel">
    Deploy Next.js, React, and other frontend frameworks
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Connect Platform">
    Link your Netlify or Vercel account to VibeHub
  </Step>

  <Step title="Configure Project">
    Select which site to deploy your project to
  </Step>

  <Step title="Deploy">
    Click the deploy button to ship your code
  </Step>

  <Step title="Monitor">
    View deployment status and history
  </Step>
</Steps>

## Prerequisites

Before you can deploy, you need:

1. **A VibeHub project** with code to deploy
2. **A platform account** (Netlify or Vercel)
3. **Owner access** to the VibeHub project

<Note>
  Only project owners can configure and trigger deployments.
</Note>

## Platform Connection

Connecting a platform is a one-time setup:

1. Go to VibeHub **Settings** (user settings, not project)
2. Find **Connected Platforms**
3. Click **Connect** next to Netlify or Vercel
4. Authorize VibeHub in the platform's OAuth flow
5. You're connected!

Once connected, you can use that platform for any project you own.

## Deployment Configuration

Each project needs to be configured for deployment:

| Setting           | Description                            |
| ----------------- | -------------------------------------- |
| **Platform**      | Which service to deploy to             |
| **Site**          | Specific site/project on that platform |
| **Build Command** | Optional command to run before deploy  |

## Deployment Status

After deploying, you can track:

* **Deployment State** - Building, deploying, success, or failed
* **Deployment URL** - Link to the live site
* **Timestamp** - When the deployment happened
* **Commit** - Which commit was deployed

## Deployment History

VibeHub keeps a history of your deployments so you can:

* See past deployments
* Identify which commits were deployed
* Track deployment frequency
* Debug failed deployments

## Benefits of VibeHub Deployment

### Single Dashboard

Manage code and deployments in one place. No need to switch between multiple tools.

### Commit Tracking

See exactly which commit is deployed. Trace issues back to specific changes.

### Quick Deploy

Deploy any commit with one click. Test specific versions easily.

## When to Use VibeHub Deployment

<AccordionGroup>
  <Accordion title="Staging Environments" icon="flask">
    Deploy feature branches to staging for testing before merging
  </Accordion>

  <Accordion title="Quick Fixes" icon="bolt">
    Deploy hotfixes immediately without leaving VibeHub
  </Accordion>

  <Accordion title="Demo Deployments" icon="presentation">
    Spin up demos for stakeholders from specific commits
  </Accordion>
</AccordionGroup>

## Limitations

* Deployments are triggered manually (no auto-deploy on push yet)
* Build settings are basic (complex builds may need platform config)
* One deployment target per project

## Next Steps

<CardGroup cols={2}>
  <Card title="Connect Netlify" icon="n" href="/deployment/connecting-netlify">
    Set up Netlify deployment
  </Card>

  <Card title="Connect Vercel" icon="triangle" href="/deployment/connecting-vercel">
    Set up Vercel deployment
  </Card>
</CardGroup>