Agent Workflow Testing

Bootstrap project for verifying changes in a Go + React app with Postgres and an nginx dev proxy.

Layout

• backend/ Go API server (multi-module with shared/).
• frontend/ React app (Vite).
• nginx/ reverse proxy for / (frontend) and /api (backend).

Dev workflow

docker-compose up --build

Frontend dependencies are installed inside the container with a dedicated frontend-node-modules volume, and the compose file only bind-mounts the frontend sources/config, so node_modules is not created on the host.

Visit:

• http://localhost:8088 (nginx proxy)
• http://localhost:8080/api/health (backend direct)
• http://localhost:5173 (frontend direct)

API

• GET /api/health
• GET /api/messages
• POST /api/messages { "content": "hello" }

Playwright

This target starts the stack and stops it afterward:

make e2e-playwright

Run Playwright inside Docker:

make e2e-playwright-in-docker

Run Playwright against a remote browser already exposed on localhost:3000:

make e2e-playwright-remote

This uses host networking and PLAYWRIGHT_WS_ENDPOINT=ws://localhost:3000/chrome/playwright.

Cypress

This target starts the stack and stops it afterward:

make e2e-cypress

Run Cypress inside Docker:

make e2e-cypress-in-docker

Selenium

This target starts the stack and stops it afterward:

make e2e-selenium

To run Selenium against a remote browser exposed on localhost:3000:

make e2e-selenium-remote

This uses host networking so the test container can reach both the app and the remote browser. The defaults are SELENIUM_REMOTE_URL=http://localhost:3000 and SELENIUM_BASE_URL=http://localhost:8088.

Override endpoints as needed:

• SELENIUM_REMOTE_URL (defaults to http://localhost:3000)

Puppeteer

This target starts the stack and stops it afterward:

make e2e-puppeteer

To run Puppeteer against a remote browser exposed on localhost:3000:

make e2e-puppeteer-remote

This uses host networking so the test container can reach both the app and the remote browser. The defaults are PUPPETEER_WS_ENDPOINT=ws://localhost:3000 and PUPPETEER_BASE_URL=http://localhost:8088.