> For the complete documentation index, see [llms.txt](https://dework.gitbook.io/product-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dework.gitbook.io/product-docs/integrations/github.md).

# GitHub

Two-way sync for your developers to be connected with your team and community

## Overview

Creating issues in GitHub will automatically create tasks in Dework and tasks can be linked to pull requests to automatically update their status.

This is an overview of this integration's basics. For a more practical guide, see  🖥 [Bountied Issues with Github + Dework](/product-docs/workflows/operations/bountied-issues-with-github-+-dework.md)

## Basics

### Setup

You will be able to configure the  `GitHub integration`  by going to a project’s  `Settings`, under the  `Integrations`  tab.

{% hint style="info" %}
One project can be connected to many repositories at the same time.
{% endhint %}

![Finding the Github integration](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2Fl37uJRfZHx2WfhiZGDXU%2FIntegrations-GitHub-01.jpg?alt=media\&token=3a02acb9-fd98-43bf-99a3-5b9c7789b111)

### Integration Options

It’s a two-way sync: you can both create Tasks from your GitHub Issues and create Issues from your Dework Tasks.

![Connecting a repo](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FbtBjbAuKBu39YTnZSmh2%2FIntegrations-GitHub-02.jpg?alt=media\&token=acd8d60f-2b2d-4483-8b53-c1aa1ada1fb5)

#### Import existing Github issues to Dework

If selected when connecting the repo, it will import all existing issues from that repo to Dework. New Dework tasks will be created and things like issue `Name`, `Description` and `Labels` will carry over. 

#### Create Dework Tasks from GitHub Issues

This is enabled by default. New issues created in your GitHub repository will automatically create tasks in the `To Do` column of your Dework project. Some metadata like issue `Name`, `Description` and `Labels` will carry over.

#### Create GitHub Issues when Dework task is created 

You can decide to enable it right after selecting a repository to connect in your project  `Settings`. When creating a task in your project on Dework, it will automatically create an issue in your GitHub repository.

{% hint style="success" %}
For bigger GitHub repos, you might not always want to sync all issues to Dework. When adding a repo, you can select which labels should be synced

**Note**: If your repos are already connected, you will need to disconnect & reconnect to enable this
{% endhint %}

![Select specifically labelled issues to sync from GitHub to Dework](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FWrw8KOBY08tf4Z5ke14R%2FIntegrations-GitHub-04.jpg?alt=media\&token=db06f033-0955-4031-8d23-a766ef86591e)

### Link tasks with Pull Requests

After connecting a repository to a project, we will automatically generate branch names for your tasks that you can then use to link a specific task to a new branch.

Ex: `git checkout -b jala/dw-2208/show-onboarding-flow-for`

This branch name can be found when clicking the  `Link GitHub Branch`  button on your tasks.

![Linking a branch to a task](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FNg8wlWlWpJe6ea21HHVg%2FIntegrations-GitHub-03.jpg?alt=media\&token=84af4605-9388-4759-bce3-9f3b849eb478)

{% hint style="success" %}
**Automation**: After linking a task to a branch, if a Pull Request is opened, the task’s status will automatically change to In Review. Then, if the PR is merged, the task will move to Done.
{% endhint %}

## Use Cases

🖥 [Bounties Issues with Github + Dework](/product-docs/workflows/operations/bountied-issues-with-github-+-dework.md)