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

# Importing from GitHub

> Import your existing GitHub repositories into VibeHub

## Overview

Already have code on GitHub? VibeHub makes it easy to import your repositories, bringing over your full commit history.

## Prerequisites

* A VibeHub account
* A GitHub account (for private repositories)
* The repository URL you want to import

<Note>
  Public GitHub repositories can be imported without connecting your GitHub account. For private repositories, you'll need to authorize VibeHub.
</Note>

## Import Process

<Steps>
  <Step title="Open Import Modal">
    From your dashboard, click the **Import from GitHub** button
  </Step>

  <Step title="Connect GitHub (First Time Only)">
    If importing a private repository, click **Connect with GitHub** to authorize VibeHub. This grants read access to your repositories.
  </Step>

  <Step title="Enter Repository URL">
    Paste your GitHub repository URL:

    ```
    https://github.com/username/repository-name
    ```
  </Step>

  <Step title="Preview Repository">
    VibeHub will fetch repository details and show you:

    * Repository name and description
    * Public/private status

    You can edit the project name and description before importing.
  </Step>

  <Step title="Start Import">
    Click **Import** to begin. You'll see real-time progress showing:

    * Commits imported
    * Files imported
    * Overall progress percentage
  </Step>

  <Step title="View Your Project">
    Once complete, click **View Project** to see your imported repository in VibeHub
  </Step>
</Steps>

## What Gets Imported?

| Content                         | Imported            |
| ------------------------------- | ------------------- |
| Commits (up to 100 most recent) | Yes                 |
| Commit messages                 | Yes                 |
| Commit authors                  | Yes                 |
| File contents                   | Yes                 |
| Branches                        | Default branch only |
| Issues                          | No                  |
| Pull requests                   | No                  |
| GitHub Actions                  | No                  |

<Info>
  VibeHub imports up to **100 of your most recent commits** to keep imports fast and manageable. For repositories with extensive history, the most recent commits are prioritized.
</Info>

## GitHub Connection

### Connecting Your Account

When you first import a private repository, you'll be prompted to connect your GitHub account:

1. Click **Connect with GitHub**
2. You'll be redirected to GitHub to authorize VibeHub
3. Grant the requested permissions
4. You'll be redirected back to VibeHub

### Permissions Requested

VibeHub requests minimal permissions:

* Read access to your repositories
* Read access to your profile information

### Disconnecting GitHub

To disconnect your GitHub account:

1. Go to **Settings** in VibeHub
2. Find the **Connected Platforms** section
3. Click **Disconnect** next to GitHub

<Warning>
  Disconnecting GitHub won't delete your imported projects, but you won't be able to import new private repositories until you reconnect.
</Warning>

## Troubleshooting

### Repository Not Found

If you get a "repository not found" error:

* Verify the URL is correct
* Make sure you have access to the repository on GitHub
* For private repos, ensure GitHub is connected

### Import Taking Too Long

Large repositories may take several minutes to import. The import runs in the background - you can navigate away and check back later.

### Missing Commits

Remember that VibeHub imports only the most recent 100 commits. If you need older history, consider using the CLI to push specific commits.

## Next Steps

<CardGroup cols={2}>
  <Card title="View Commits" icon="code-commit" href="/version-control/commits">
    Explore your imported commit history
  </Card>

  <Card title="Invite Collaborators" icon="user-plus" href="/collaboration/inviting-collaborators">
    Add team members to work together
  </Card>
</CardGroup>