> For the complete documentation index, see [llms.txt](https://bugowl.gitbook.io/bugowl-ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bugowl.gitbook.io/bugowl-ai/quick-start.md).

# Quick Start

### Get Up and Running in Minutes

Welcome to BugOwl AI! This guide will help you create and run your first test in under 10 minutes. No technical expertise required—just follow these simple steps.

### Step 1: Sign Up and Verify

1. **Create Your Account**
   * Visit our signup page
   * Enter your email address and create a password
   * Check your email for verification link
   * Click the verification link to activate your account
2. **Log In**
   * Return to our login page
   * Enter your credentials
   * You'll be redirected to your dashboard

### Step 2: Create Your First Project

1. **Navigate to Projects**
   * From the dashboard sidebar, click "Projects"
   * Click "Create New Project"
2. **Project Setup**
   * Enter a project name (e.g., "My Website Tests")
   * Add a description (optional)
   * Click "Create Project"

### Step 3: Add an Environment

1. **Go to Environments**
   * Click "Environments" in the sidebar
   * Click "Create New Environment"
2. **Environment Configuration**
   * Enter environment name (e.g., "Production" or "Staging")
   * Add your website's base URL (e.g., `https://mywebsite.com`)
   * Configure authentication if needed (optional)
   * Click "Save Environment"

### Step 4: Create Your First Test Case

1. **Navigate to Test Cases**
   * Click "Test Cases" in the sidebar
   * Click "Create New Test Case"
2. **Write Your Test**
   * Enter test name (e.g., "Login Test")
   * In the test description, write your steps in plain English:

     ```
     Navigate to the login page
     Enter username "test@example.com"
     Enter password "password123"
     Click the login button
     Verify that the dashboard page loads
     Check that "Welcome" message is displayed
     ```
3. **Save Your Test**
   * Click "Save Test Case"
   * Your test is now ready to run

### Step 5: Run Your Test

1. **Execute the Test**
   * From your test case page, click "Run Test"
   * Select your environment from the dropdown
   * Click "Start Test"
2. **Monitor Progress**
   * Watch the test execution in real-time
   * View console logs and network activity
   * See screenshots as the test progresses

### Step 6: View Results

1. **Check Test Results**
   * Navigate to "Test Results" in the sidebar
   * Click on your completed test
   * Review the detailed execution report
2. **Analyze the Results**
   * View step-by-step execution log
   * Check screenshots for each action
   * Review any failures or warnings
   * See performance metrics

### What's Next?

Congratulations! You've successfully created and run your first test. Here are some next steps:

* **Create More Tests**: Add additional test cases for different scenarios
* **Organize with Test Suites**: Group related tests together
* **Schedule Tests**: Set up automated test runs
* **Add Team Members**: Invite colleagues to collaborate
* **Explore Integrations**: Connect with Slack, Jira, or GitHub

### Need Help?

* Check our Troubleshooting Guide for common issues
* Visit our FAQ for quick answers
* Contact support through the in-app support dialog

Ready to dive deeper? Explore our Core Concepts section to learn more about BugOwl's powerful features.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://bugowl.gitbook.io/bugowl-ai/quick-start.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.