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

# GitHub

> Connect your Nextd projects to GitHub for seamless version control, team collaboration, and automatic bidirectional synchronization.

## Overview

GitHub integration seamlessly connects your Nextd projects to GitHub repositories, providing enterprise-grade version control, team collaboration, and code portability. This powerful integration ensures your code is always backed up, versioned, and ready for collaborative development.

<Tip>
  GitHub integration provides automatic bidirectional sync, meaning changes made in either Nextd or GitHub are instantly reflected on both platforms without manual intervention.
</Tip>

## Key Benefits

* **Automatic Version Control** - Complete Git history and automated commits
* **Real-time Bidirectional Sync** - Instant synchronization between Nextd and GitHub
* **Team Collaboration** - Support for Pull Requests, Issue tracking, and code reviews
* **Code Portability** - Standard Git workflow, deployable to any platform

## Setup Process

<Steps>
  <Step title="Initiate Connection">
    In the Nextd editor, click **GitHub → Connect to GitHub** and authorize the Nextd application to access your GitHub account.
  </Step>

  <Step title="Select Account">
    Choose between your personal account or organization account. Ensure you have administrator permissions to create and manage repositories.
  </Step>

  <Step title="Repository Creation">
    Nextd automatically creates a new GitHub repository and pushes your initial project code. The repository will be configured with appropriate settings for seamless synchronization.
  </Step>

  <Step title="Verify Sync">
    Confirm the connection is working by making a small change in Nextd and verifying it appears in your GitHub repository within moments.
  </Step>
</Steps>

## Synchronization Features

<Info>
  The GitHub integration uses intelligent webhooks to maintain real-time synchronization between platforms without manual intervention.
</Info>

* **Default Branch Focus** - Syncs the main/primary branch automatically
* **Bidirectional Updates** - Changes flow seamlessly in both directions
* **Automated Operations** - No manual git commands required
* **Conflict Detection** - Smart handling of simultaneous edits
* **Instant Propagation** - Changes appear within seconds

## Limitations

<Warning>
  **Account Limitations:** Each Nextd account can connect to only one GitHub account, and automatic sync is limited to the default branch.
</Warning>

* **Single Account Binding** - One GitHub account per Nextd account
* **Default Branch Only** - Non-default branches don't auto-sync
* **Repository Import** - Cannot directly import existing external repositories

## Best Practices

<Accordion title="Code Management" icon="code">
  **Commit Standards:**

  * Use clear, descriptive commit messages
  * Follow conventional commit format when possible
  * Make atomic commits for easier tracking

  **Branch Strategy:**

  * Use the default branch for main development in Nextd
  * Create feature branches in GitHub for complex features
  * Merge back to default branch to maintain sync

  **Documentation:**

  * Keep README files updated
  * Document integration setup and workflow
  * Maintain project change logs
</Accordion>

<Accordion title="Team Collaboration" icon="users">
  **GitHub Features:**

  * Utilize Issues for project management
  * Implement Pull Request workflows
  * Use GitHub Projects for milestone tracking

  **Review Process:**

  * Establish code review requirements
  * Set up branch protection rules
  * Configure automated checks and tests

  **Communication:**

  * Use GitHub Discussions for team planning
  * Tag team members in relevant issues
  * Maintain clear contributor guidelines
</Accordion>

<Note>
  GitHub integration transforms Nextd into a powerful collaborative development platform, combining AI-assisted development with professional version control and team collaboration capabilities.
</Note>

***

*Ready to connect your projects to GitHub? Start with the setup process above or contact our support team for assistance.*