This quickstart guide shows you how to set up Bugster CLI, create and run your first AI-powered tests in minutes.

After you complete this guide, you will have automated tests running against your web application.

Prerequisites: Before you begin, create a Bugster account and ensure you have a Next.js project ready.

Getting Started

You can get started with Bugster CLI in three simple steps:

  1. Initialize bugster init - Configure your project with authentication and settings
  2. Generate bugster generate - AI analyzes your code and creates test specifications
  3. Run bugster run - Execute tests with browser automation against your application

Let’s walk through each step:

0. Install Bugster CLI

First, install the Bugster CLI on your system.

Install Bugster CLI

Visit our installation guide for detailed setup instructions

1. Initialize Bugster in your project

Navigate to your project’s root directory and initialize Bugster:

cd your-nextjs-project
bugster init

This command sets up Bugster configuration for your specific project, creating the necessary files and folders to store your tests and settings.

Configuration Setup

During initialization, you’ll be prompted for:

Learn More About Project Initialization

Visit our init guide for advanced options and customization

2. Generate Your First Tests

Create test specifications for your application using:

bugster generate

This command analyzes your codebase and automatically creates test specifications under each page. It understands your application structure and generates relevant test cases.

Learn More About Test Generation

Visit our generate guide for advanced options and customization

3. Run Your Tests

Execute the generated tests against your application:

bugster run

This command executes your test specifications in a browser, validating the instructions in the test specification.

Make sure your application is running on the configured base URL before running tests.

Advanced Test Execution

Learn about test execution options and configurations

GitHub Integration

Install the GitHub App

Connect Bugster to your GitHub repository for automated testing on pull requests.

The GitHub integration enables Bugster to automatically run tests on pull requests, providing immediate feedback on code changes and preventing regressions.

1

Access GitHub Integration

Visit the Bugster Dashboard and navigate to GitHub integration settings and click "Connect Organization" .

2

Install the App

Select your organization or user account, then choose the repository you want to integrate with Bugster.

GitHub App

Visit github integration for details and guidance on GitHub App Installation.

3

Enable Preview Access

If using Vercel or Railway you must grant Bugster permissions for previews

4

Commit Bugster Configuration with your changes

Add the .bugster folder to your repository:

git add .bugster/
git commit -m "Add Bugster CLI configuration"
git push origin main
5

Create a Pull Request

Create a pull request to see Bugster in action. The GitHub app will automatically run your tests and report results.

Next Steps

Congratulations! You now have Bugster CLI set up and running. Here’s what to explore next:

Troubleshooting

Need help? Visit our documentation or reach out to our support team through the Bugster Dashboard.