GitHub Integration

Connect your GitHub repositories to FanDesk projects for seamless development workflow.

Connecting GitHub

Organization Setup

1. Go to Settings > Integrations
2. Click Connect GitHub
3. Install the FanDesk GitHub App
4. Select which repositories to grant access

Linking to Projects

1. Open project settings
2. Go to GitHub tab
3. Click Link Repository
4. Select from your connected repos

Linked Features

Issue Syncing

GitHub issues appear in FanDesk:

Synced information:

• Issue title and body
• State (open/closed)
• Labels
• Assignees

PR/Commit Linking

Link pull requests and commits to tasks:

1. Open a task
2. Click Link GitHub
3. Paste PR/commit URL or select from recent

The task shows:

• PR title and status
• CI status (pending/success/failure)
• Author and date

CI Status Display

See CI status directly on tasks:

CI status syncs every 5 minutes.

Auto-Collaborator Management

When enabled, FanDesk automatically:

1. Detects project members with GitHub usernames
2. Invites them as repo collaborators
3. Sets appropriate permission level

This happens when:

• User joins a project
• Repo is linked to project

Desk Mate GitHub Commands

Use the AI assistant for GitHub operations:

Best Practices

Branch Naming

Include task key in branch names:

feature/BACK-42-user-authentication
bugfix/MOBILE-15-crash-on-login

Commit Messages

Reference task keys in commits:

BACK-42: Add user authentication flow

- Implement login/logout
- Add session management
- Write unit tests

PR Descriptions

Link related tasks in PR descriptions:

## Related Tasks
- Closes BACK-42
- Related to BACK-38

---

Next: Learn about email management in Mail.