> ## 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.

# Connecting Netlify

> Set up Netlify deployment for your VibeHub projects

## Overview

Netlify is a popular platform for deploying static sites, serverless functions, and full-stack applications. Connect your Netlify account to deploy directly from VibeHub.

## Prerequisites

Before connecting:

* A [Netlify account](https://netlify.com) (free tier works)
* Owner access to your VibeHub project

## Connecting Your Netlify Account

<Steps>
  <Step title="Open VibeHub Settings">
    Click your profile icon and go to **Settings**
  </Step>

  <Step title="Find Connected Platforms">
    Scroll to the **Connected Platforms** section
  </Step>

  <Step title="Click Connect for Netlify">
    Click the **Connect** button next to Netlify
  </Step>

  <Step title="Authorize in Netlify">
    You'll be redirected to Netlify. Log in and authorize VibeHub to access your account.
  </Step>

  <Step title="Return to VibeHub">
    After authorization, you'll be redirected back. Netlify is now connected!
  </Step>
</Steps>

<Tip>
  You only need to connect Netlify once. After that, you can use it for any project.
</Tip>

## Configuring a Project for Netlify

After connecting your account, configure each project:

<Steps>
  <Step title="Open Project Settings">
    Go to your project and click the **Settings** tab
  </Step>

  <Step title="Find Deployment Section">
    Scroll to the **Deployment** section
  </Step>

  <Step title="Select Netlify">
    Choose Netlify as your deployment platform
  </Step>

  <Step title="Choose a Site">
    Select an existing Netlify site or create a new one
  </Step>

  <Step title="Save Configuration">
    Click **Save** to store your deployment settings
  </Step>
</Steps>

## Creating a New Netlify Site

If you don't have an existing site:

1. In the site selection, click **Create New Site**
2. Enter a name for your site (will be `your-name.netlify.app`)
3. Click **Create**
4. The new site is automatically selected

## Deploying to Netlify

Once configured, deploying is simple:

1. Go to your project dashboard
2. Click the **Deploy** button
3. Watch the deployment progress
4. Click the URL to view your live site

## Deployment Settings

| Setting               | Description                                           |
| --------------------- | ----------------------------------------------------- |
| **Site**              | Which Netlify site to deploy to                       |
| **Build Command**     | Command to run before deploy (e.g., `npm run build`)  |
| **Publish Directory** | Folder containing built files (e.g., `dist`, `build`) |

<Note>
  If your project needs a build step, make sure to configure the build command and publish directory in your Netlify site settings.
</Note>

## Viewing Deployment Status

After deploying, you'll see:

* **Status** - Building, Deploying, Ready, or Failed
* **URL** - Link to your deployed site
* **Deploy Time** - When the deployment completed

## Troubleshooting

### Authorization Failed

If the OAuth flow fails:

1. Make sure you're logged into Netlify
2. Clear your browser cookies
3. Try connecting again

### Deployment Failed

If a deployment fails:

1. Check the Netlify dashboard for error logs
2. Verify your build command is correct
3. Ensure all dependencies are installed
4. Check that the publish directory exists

### Site Not Appearing

If your Netlify sites don't show up:

1. Verify Netlify is connected in Settings
2. Check that you have sites in your Netlify account
3. Try disconnecting and reconnecting Netlify

## Disconnecting Netlify

To disconnect your Netlify account:

1. Go to VibeHub **Settings**
2. Find **Connected Platforms**
3. Click **Disconnect** next to Netlify

<Warning>
  Disconnecting won't delete your Netlify sites or deployments, but you won't be able to deploy from VibeHub until you reconnect.
</Warning>

## Next Steps

<CardGroup cols={2}>
  <Card title="Deploy Your Project" icon="rocket" href="/deployment/deploying-projects">
    Learn the deployment workflow
  </Card>

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