> For AI agents: the complete documentation index is at [llms.txt](https://reflex.dev/docs/llms.txt). For a Markdown version, remove the trailing slash from the page URL and append `.md`. The docs home is available at [index.md](http://localhost:3000/docs/index.md).

---
tags: Developer Tools
description: Connect your app to GitHub to automate workflows, manage repositories, and integrate developer operations.
---
# GitHub Integration

The **GitHub Integration** lets your app connect directly to [GitHub](https://github.com) to automate actions, fetch data, and build powerful developer workflows. Once connected, your app can interact with repositories, issues, pull requests, and more.

## What You Can Do

With GitHub, your app can:
- Fetch and display repository data (commits, branches, issues, etc.).  
- Create or update issues, pull requests, and discussions.  
- Trigger workflows or CI/CD pipelines.  
- Sync GitHub activity into your app’s dashboards or automations.  
- Build custom developer tools using GitHub’s API.

## Step 1: Generate a Personal Access Token

1. Go to your [GitHub Settings](https://github.com/settings/tokens).  
2. Navigate to **Developer settings → Personal access tokens**.  
3. Click **Generate new token** (classic or fine-grained).  
4. Select the required scopes (e.g., `repo`, `workflow`, `read:user`).  
5. Copy the token.  
   **Example token:**  
```
ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```
(Note: Replace the above value with your actual GitHub token)

> 💡 Fine-grained tokens are recommended for better security.

## Step 2: Configure the Integration in Your App

1. In your app, go to **Integrations → Add GitHub**.  
2. Paste your **GitHub Personal Access Token** in the input field.  
3. Click **Connect** to validate and save your integration.

Once connected, your app can start interacting with GitHub through workflows and actions.

## Step 3: Notes

* **Keep your token secure:** Never expose your GitHub token in public code.  
* **Use fine-grained permissions:** Limit access to only what’s needed.  
* **API rate limits:** GitHub imposes API limits, so plan automations accordingly.  
* **Combine with AI:** For example, auto-generate release notes from commits or summarize PRs with LLMs.