Quick Start

Get started with DebuggAI in under 10 minutes. This guide walks you through account setup, project creation, and running your first AI-powered test.

1. Sign Up

Create your account at app.debugg.ai.

What you will see:

• Sign up form with email/password or OAuth options (Google, GitHub)
• Email verification step (check your inbox)

Expected outcome: You are logged in and redirected to the onboarding wizard.

2. Complete Onboarding Wizard

The onboarding wizard configures your account preferences and workspace settings.

Steps:

1. Company/Team Setup - Enter your organization name and invite team members (optional)
2. Preferences - Select your primary framework (Next.js, React, Django, etc.)
3. Notification Settings - Configure email and Slack notifications

What you will see:

• Multi-step form with progress indicator
• Skip options for non-essential steps
• Summary screen before completion

Expected outcome: Your workspace is configured and you reach the main dashboard.

Team collaboration details

3. Create Your First Project

Projects organize your tests and connect to your codebase.

From the dashboard:

1. Click New Project
2. Enter a project name
3. Select your framework from the dropdown
4. Choose one of:
   • Link Repository - Connect to GitHub (recommended)
   • Standalone Project - Create without repository connection

What you will see:

• Project creation modal with name and framework fields
• Repository selection dropdown (if linking GitHub)
• Project settings page after creation

Expected outcome: Your project appears in the dashboard sidebar, ready for configuration.

Project setup details

4. Connect GitHub (Optional but Recommended)

GitHub integration enables automated testing on pull requests.

To connect:

1. Navigate to Settings (gear icon in sidebar)
2. Select GitHub Integration
3. Click Connect GitHub
4. Authorize the DebuggAI GitHub App
5. Select which repositories to grant access

What you will see:

• GitHub OAuth authorization screen
• Repository selection list
• Connection status confirmation

After connecting:

• Return to your project
• Go to the GitHub tab
• Select the linked repository
• Enable PR triggers (on open, on new commits)

Expected outcome: Your repository is linked and tests will run automatically on pull requests.

Full GitHub integration guide

5. Create Your First Test

Write tests using natural language descriptions.

From your project page:

1. Navigate to the Tests tab
2. Click New Test
3. Enter a test description in plain English:

   Test user can log in with valid credentials

4. Configure test settings (optional):
   • Target URL or route
   • Browser viewport
   • Environment variables

Writing effective test descriptions:

Good: "Test user registration flow completes successfully"
Good: "Verify shopping cart updates when adding products"
Avoid: "Test the app" (too vague)

What you will see:

• Test creation form with description field
• Optional configuration expandable sections
• Save and Run buttons

Expected outcome: Your test is saved and appears in the test list.

Writing effective tests

6. Run and View Results

Execute your test and analyze the results.

To run a test:

1. Select your test from the list
2. Click Run Test
3. Watch the execution in real-time

What you will see during execution:

• Live status updates (queued, building, running)
• Build logs for your application
• Browser actions as they occur

In the results viewer:

• Pass/Fail status with detailed breakdown
• Screenshots captured at each step
• Video recording of the full test run
• Execution log showing AI decisions and actions
• Performance metrics (load times, element discovery)

Interpreting results:

• Green checkmarks indicate successful steps
• Red indicators show failures with explanations
• Screenshots reveal exactly what the AI "saw"
• Logs explain the reasoning behind each action

Expected outcome: You understand whether your test passed, and if not, why it failed.

Understanding test results

What's Next?

Recommended next steps:

• Configure environment secrets - Add database URLs and API keys for your tests
• Set up VS Code extension - Run tests directly from your editor
• Configure PR triggers - Automate testing on every pull request
• Invite team members - Collaborate on tests and review results

Choose your workflow:

Workflow	Best For	Setup Time
GitHub Integration	Automated PR testing	5 minutes
VS Code Extension	Local development testing	2 minutes
MCP Server	Claude Desktop integration	3 minutes
Debugg CLI	CI/CD pipelines	5 minutes

Troubleshooting

Account issues:

• Check spam folder for verification email
• Try password reset if login fails
• Contact support@debugg.ai for access issues

Project not appearing:

• Refresh the dashboard
• Check webhook delivery in GitHub settings
• Verify DebuggAI app has repository access

Tests not running:

• Ensure environment secrets are configured
• Check build logs for startup errors
• Verify your app builds successfully locally

Full troubleshooting guide