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

# GitHub Connection for AI-Powered Code Generation

> Connect YouWare to GitHub repositories for version control, collaboration, and intelligent code generation with full repository context.

## Understanding the GitHub Connection Tool

The GitHub connection links your YouWare project to a GitHub repository, providing version control, collaboration features, and secure code backup. The AI can read your existing code to understand your project's structure, tech stack, and coding style, ensuring seamlessly integrated code generation.

<CardGroup cols={3}>
  <Card title="Version Control" icon="code-branch">
    Track every change with full rollback capability and GitHub workflows
  </Card>

  <Card title="Code Context" icon="brain">
    AI reads your codebase to understand structure, tech stack, and coding style
  </Card>

  <Card title="Team Collaboration" icon="users">
    Work seamlessly with developers using Pull Requests and Issues
  </Card>
</CardGroup>

## Generate Your GitHub Personal Access Token for MCP Connection

To connect GitHub, you need a Personal Access Token (PAT). Follow the visual guide below to create your token:

<Frame>
  <img src="https://mintcdn.com/youware-18c86901/ZKaGMh0Yuq54Ftak/images/github-integration.png?fit=max&auto=format&n=ZKaGMh0Yuq54Ftak&q=85&s=91089b598619c1b798751df6166395b0" alt="Step-by-step guide to creating GitHub Personal Access Token for YouWare MCP integration" width="1664" height="4094" data-path="images/github-integration.png" />
</Frame>

### Key Configuration Points

<Tip>
  **Token Name**: Use a descriptive name like `YouWare MCP` to easily identify this token later
</Tip>

<Tip>
  **Repository Access**: Select **Public repositories** for basic access. This allows MCP to read from your public repositories, which is typically sufficient for AI-powered webpage generation
</Tip>

<Tip>
  **Expiration**: Choose an expiration time that fits your workflow. Shorter expiration times are more secure
</Tip>

<Warning>
  **Critical**: Copy your personal access token immediately after generation—you won't be able to see it again! Store it securely and never share it publicly or commit it to version control.
</Warning>

<Info>
  Need more details? Visit the [GitHub Personal Access Token creation page](https://github.com/settings/tokens/new) to get started.
</Info>

## Real-World Use Cases

<Tabs>
  <Tab title="Pro Creator">
    **Scenario**: Maintaining a public open-source library with auto-generated documentation that stays in sync with code changes

    **How It Helps**: The AI reads your GitHub repository to understand code structure and generates the documentation site. With each new version push, the AI automatically updates docs—ensuring zero documentation drift.
  </Tab>

  <Tab title="Small Business">
    **Scenario**: Enforcing code standards across a distributed development team

    **How It Helps**: The AI reads your existing GitHub codebase to learn your style, ensuring all new components and features are perfectly consistent. This tech-driven consistency saves countless hours in code review and refactoring.
  </Tab>
</Tabs>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What permissions does the Personal Access Token need?">
    For basic read access to public repositories, minimal permissions are sufficient. For private repositories or write access, you'll need to grant additional scopes.
  </Accordion>

  <Accordion title="Is my code secure?">
    Yes. The token is used only to read repository data via GitHub's secure API. Always keep your token private and never share it publicly.
  </Accordion>

  <Accordion title="Can I revoke access later?">
    Absolutely. You can revoke or regenerate tokens at any time from your GitHub settings.
  </Accordion>

  <Accordion title="Does this work with private repositories?">
    Yes, but you'll need to configure the token with appropriate permissions for private repository access.
  </Accordion>
</AccordionGroup>