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

# Inviting Collaborators

> Add team members to your VibeHub projects

## Overview

Collaboration is at the heart of software development. VibeHub makes it easy to invite team members to work on your projects together.

## Who Can Invite Collaborators?

Only **project owners** can invite new collaborators. If you created the project, you're the owner.

## Sending an Invitation

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

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

  <Step title="Click Invite Collaborator">
    Click the **Invite Collaborator** button
  </Step>

  <Step title="Enter Email Address">
    Type the email address of the person you want to invite
  </Step>

  <Step title="Select Permission Level">
    Choose the appropriate permission level:

    * **Read Only** - Can view and pull code
    * **Read & Write** - Can view, pull, and push code
  </Step>

  <Step title="Send Invitation">
    Click **Send Invitation** to send the invite
  </Step>
</Steps>

## Permission Levels

Choose the right permission level for each collaborator:

| Permission       | View Project | Pull Code | Push Code | Manage Settings |
| ---------------- | ------------ | --------- | --------- | --------------- |
| **Read Only**    | Yes          | Yes       | No        | No              |
| **Read & Write** | Yes          | Yes       | Yes       | No              |
| **Owner**        | Yes          | Yes       | Yes       | Yes             |

<Tip>
  Start with **Read Only** if you're unsure. You can always upgrade permissions later.
</Tip>

## What Happens After Inviting?

1. **Email Sent** - The invitee receives an email with a link to accept
2. **Pending Status** - The invitation appears as "Pending" in your collaborators list
3. **Acceptance** - When they click the link and sign in, they're added to the project
4. **Access Granted** - They can now see the project on their dashboard

## Invitation Expiration

Invitations expire after a set period (typically 7 days). If an invitation expires:

* It shows as "Expired" in your list
* You can resend it by clicking **Resend**
* A new invitation email is sent

## Managing Pending Invitations

In the Collaborators section, you'll see two lists:

### Active Collaborators

People who have accepted and have access.

### Pending Invitations

Invitations that haven't been accepted yet.

For pending invitations, you can:

* **Resend** - Send the invitation email again
* **Revoke** - Cancel the invitation before it's accepted

## Invitation Not Received?

If your invitee says they didn't receive the email:

1. Check they gave you the correct email address
2. Ask them to check their spam/junk folder
3. Try resending the invitation
4. Make sure they have a VibeHub account (they'll create one when accepting)

## Email-First Collaboration

VibeHub uses an email-first approach to collaboration:

* **No username needed** - Just an email address
* **Works with any email** - Personal or work emails
* **Secure** - Invitation links are unique and expire

<Note>
  The person you invite doesn't need an existing VibeHub account. They'll create one when they accept the invitation.
</Note>

## Next Steps

<CardGroup cols={2}>
  <Card title="Manage Permissions" icon="shield" href="/collaboration/permissions">
    Understand permission levels in detail
  </Card>

  <Card title="Manage Your Team" icon="users" href="/collaboration/managing-team">
    Update or remove collaborators
  </Card>
</CardGroup>