GitHub Actions

Boozang supports integration with GitHub Actions using the Docker test runner for headless browser execution.

Note: This implementation can be adapted to your needs. We invite you to share any updates with us, either via email or on our forum.

Implementation steps

1. Add a directory .github in your project root
2. Create the directory .github/workflows
3. Add the below code into the file .github/workflows/boozang-tests.yml
4. Add your Boozang token as a repository secret (BZ_TOKEN)
5. Push the code
6. The job will be triggered automatically

Docker runner approach (recommended)

name: Boozang Tests
on: [push]

jobs:
  run-boozang-tests:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Run Boozang tests
        run: |
          docker run --rm --shm-size=1g \
            -v "$(pwd):/var/boozang/" \
            styrman/boozang-playwright \
            --file="report" \
            "https://ai.boozang.com/extension?token=${{ secrets.BZ_TOKEN }}#PROJECT_ID/master/MODULE/TEST/run"

      - name: Upload test reports
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: boozang-reports
          path: "*.json"

Replace PROJECT_ID, MODULE, and TEST with your project settings, or parameterize them using GitHub Actions variables.

Docker runner options

The styrman/boozang-playwright image supports additional options:

Option	Description
--file=name	Report filename (default: "report")
--screenshot	Capture screenshot after test
--video=on	Enable video recording
--keepalive	Keep browser alive after completion
--loglevel=LEVEL	Set log level (error/warning/info/debug/log)
--device=NAME	Emulate a specific device
--timeout=SEC	Command timeout in seconds
--width=1280	Browser viewport width
--height=1024	Browser viewport height