Getting Started with Aurora

Aurora is a desktop application for generating production-ready Playwright tests. This guide gets you from installation to your first generated test file.

System requirements

PlatformMinimum version
Windows10 (64-bit)
macOS12 Monterey
LinuxUbuntu 22.04 / Fedora 38

Installation

Windows

  1. Download Aurora-Setup-x.x.x.exe from your purchase confirmation email.
  2. Run the installer and follow the prompts.
  3. Aurora will appear in your Start Menu.

macOS

  1. Download Aurora-x.x.x.dmg.
  2. Open the DMG, drag Aurora to your Applications folder.
  3. On first launch, macOS may prompt you to confirm — click Open in System Settings → Privacy & Security.

Linux

  1. Download Aurora-x.x.x.AppImage.
  2. Make it executable: chmod +x Aurora-*.AppImage
  3. Run it: ./Aurora-*.AppImage

Activating your license

See the Activation Guide for step-by-step instructions.

Your first test

  1. Create a new project — File → New Project → choose your output folder.
  2. Set the base URL — enter the URL of the application you want to test.
  3. Start recording — click the Record button. Aurora opens a browser window.
  4. Interact with your app — click buttons, fill forms, navigate pages. Aurora records every action.
  5. Stop recording — click Stop. Aurora generates a Playwright test file.
  6. Review and export — edit the generated test in the built-in editor, then File → Export.

Running your tests

The exported file is a standard Playwright test. Run it with:

npx playwright test your-test.spec.ts

No additional configuration is needed — Aurora generates tests that work with a default Playwright installation.

Next steps