Onboarding Guide

Get DebugGo up and running in less than 5 minutes

5 min read

7 steps

Prerequisites

A GitHub account (for repository integration)
Write access to your repository (for adding workflows)
Access to your website's code (for widget installation)

Create Your Account

Navigate to debuggo.dev/connect and create your account using GitHub OAuth or email/password.

Screenshot: Create Account Screen

Pro Tip

We recommend using GitHub OAuth for seamless integration with your repositories.

Connect GitHub

Link your GitHub account to enable issue creation

After signing in, you'll be prompted to connect your GitHub account. Select the repositories you want to integrate with DebugGo.

Screenshot: GitHub Repository Selection

Repository Access

You can start with specific repositories and add more later via GitHub → Installed Apps → Configure.

Create a Project

Set up your first DebugGo project

Create a project for each application or website. Each project gets a unique Project ID for the embed script.

Screenshot: Create Project Dialog

Important

Save your Project ID - you'll need it for the widget installation step!

Install AI Tool (Claude Code)

Set up automated fix generation with Claude

In Claude, run the following command to install the GitHub App:

Screenshot: Claude GitHub App Installation

Coming Soon

Codex support is coming soon! Check back for updates.

Add GitHub Actions Workflows (Optional)

Automate issue labeling and fixes

Download our pre-configured GitHub Actions workflows and add them to your repository.

Auto-Fix Workflow

Automatically attempts to fix issues when triggered

.github/workflows/debuggo-auto-fix.ymlyaml

Auto-Labeler Workflow

Automatically labels issues based on content

.github/workflows/debuggo-labeler.ymlyaml

Required Secrets

Add `DEBUGGO_API_KEY` to your repository secrets: Settings → Secrets and variables → Actions

Install the DebugGo Script

Add the feedback widget to your website

Add the DebugGo widget to your website with a single line of code. Choose the appropriate method for your framework:

index.htmlhtml

CSP Configuration

If you use Content Security Policy, add `debuggo.dev` to your script-src directive.

Verify Setup

Confirm everything is working correctly

Check that the widget is loading and events are being tracked:

Check Network Tab

Open DevTools → Network tab and look for `widget.js` loading successfully

Test Widget

Click the feedback button and submit a test message

Check Dashboard

Visit your DebugGo dashboard to see the test feedback

Troubleshooting

IssueCauseSolution

Widget not showingWrong project IDCheck project ID in dashboard

Network errorsCSP blockingAdd debuggo.dev to CSP

No events in dashboardAd blockerDisable ad blocker for testing

🎉 Congratulations!

You've successfully set up DebugGo! Your application is now collecting feedback and ready for automated issue management.

Next Steps

Create your first GitHub issue from feedback
Invite team members to collaborate
Customize the widget appearance to match your brand
Set up notification preferences