1. Install playwright. Use the SDK that best matches the codebase. Default to python.

• Write a playwright config file. Make sure you use reporter: 'list' mode.
• If using python, you must use a virtual env.

2. Write and run a playwright script that lets you interact with the webapp frontend.
3. Follow these steps in a loop until the bug is fixed:

• Add many logs to the server and to the UI. You MUST do this on every loop.
• Start the server and the UI.
• Run the playwright script and identify what is happening.
• Update the playwright script.

If you get stuck: did you add logs? 4. Clean up all background jobs and close any browsers.

Web Application Testing

To test local web applications, write native Python Playwright scripts. Your testing should be as close to 'real' as possible.

Example

Identify the server

Single server:

npm run dev" --port 5173

Multiple servers (e.g., backend + frontend):

cd backend && python server.py&
cd frontend && npm run dev&

To create an automation script, include only Playwright logic

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(headless=True) # Always launch chromium in headless mode
    page = browser.new_page()
    page.goto('http://localhost:5173') # Server already running and ready
    page.wait_for_load_state('networkidle') # CRITICAL: Wait for JS to execute
    # ... your automation logic
    browser.close()

If Playwright is not available, install it in a virtual env.