Quick Start

From zero to your first annotation in under 5 minutes. No code changes to your repository.

STEP 1 — CREATE ACCOUNT

Individual user

Ideal for freelancers and solo developers. Sign up with email, GitHub, or Google.

Organization

Ideal for agencies and teams. Sign up as Organization — enter name, email, country, company size. You become the owner.

Forgot password?

Click Forgot password on the login page. You'll receive a reset link by email (expires in 1 hour).

STEP 2 — CONNECT A REPO

1Projects → New Project

2Connect your GitHub account (authorize BugDrop)

3Browse and select your repository

4Choose the branch to track (default: main)

5Review auto-detected build config (adjust if needed)

6Add environment variables if required

7Click Create — first build queues automatically

STEP 3 — INSTALL THE CLI

bash

$ npm install -g @bugdrop/cli
$ bugdrop auth sk-bd-<your-api-key>
$ cd my-project && bugdrop init
  ✓ Linked to my-project

Get your API key

Settings → API Keys → Create Key. The key is only shown once — copy it immediately.

STEP 4 — START YOUR FIRST REVIEW

1Open your project from the dashboard

2Click Start Review

3Your preview loads inside BugDrop's review interface

4Click any element to create a Point annotation

5Add a comment and severity → Submit

AI fix generated automatically

On Starter plans and above, BugDrop generates an AI fix diff within seconds of submission. Apply it from the CLI with: bugdrop apply <annotationId>

NEXT STEPS

Annotation Types

Point, area, console & network

AI Fix Suggestions

How source map tracing works

Integrations

Push to Linear, Jira, Slack