ื“ืœื’ ืœืชื•ื›ืŸ ื”ืจืืฉื™

Tutorial: GitHub Integration Setup

Connect your GitHub repositories with Gauzy for issue and commit tracking.

Step 1: Create GitHub Appโ€‹

  1. Go to GitHub โ†’ Settings โ†’ Developer settings โ†’ GitHub Apps
  2. Click New GitHub App
  3. Configure:
    • Name: Gauzy Integration
    • Homepage URL: Your Gauzy URL
    • Callback URL: {API_BASE_URL}/api/integration/github/callback
    • Webhook URL: {API_BASE_URL}/api/integration/github/webhook
  4. Permissions:
    • Issues: Read & Write
    • Pull requests: Read
    • Contents: Read
    • Metadata: Read
  5. Click Create GitHub App
  6. Generate a private key

Step 2: Configure Gauzyโ€‹

Add to your .env:

GAUZY_GITHUB_CLIENT_ID=your-app-client-id
GAUZY_GITHUB_CLIENT_SECRET=your-secret
GAUZY_GITHUB_WEBHOOK_SECRET=your-webhook-secret
GAUZY_GITHUB_APP_ID=12345
GAUZY_GITHUB_APP_NAME=gauzy-integration
GAUZY_GITHUB_APP_PRIVATE_KEY=base64-encoded-key
GAUZY_GITHUB_CALLBACK_URL=http://localhost:3000/api/integration/github/callback

Step 3: Install on Repositoryโ€‹

  1. In Gauzy, go to Integrations โ†’ GitHub
  2. Click Connect
  3. Authorize the GitHub App
  4. Select repositories to sync
  5. Click Install

Step 4: Map Projectsโ€‹

  1. After connecting, go to Integrations โ†’ GitHub โ†’ Settings
  2. Map GitHub repositories to Gauzy projects
  3. Configure sync options:
    • Sync issues โ†’ tasks
    • Sync commits โ†’ activity
    • Sync labels โ†’ tags

Step 5: Verifyโ€‹

  • Create an issue in GitHub โ†’ appears as a task in Gauzy
  • Commit with issue reference โ†’ linked in activity