Web Ng Docker Loop
Testing & Qualityweb-ng-docker-loopWeb Ng Docker Loop is an Agent Skill for testing & quality published in the carverauto/serviceradar repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Run ServiceRadar `elixir/web-ng` locally against the Docker Compose CNPG database with copied mTLS certs and Docker secrets, then verify dashboard UI changes with Playwright. Use when iterating on web-ng, dashboard package, custom React dashboard, UAL WiFi map, SRQL topbar, or browser screenshot behavior without rebuilding the web-ng release image.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/carverauto/serviceradar/blob/HEAD/.agents/skills/web-ng-docker-loop/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/web-ng-docker-loop, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Web-NG Docker Loop
Use this skill for fast local UI iteration when Docker Compose is already running the ServiceRadar mTLS stack. Prefer this loop over Bazel/release-image rebuilds until the final Docker parity check.
Quick Start
From the ServiceRadar repo root:
.agents/skills/web-ng-docker-loop/scripts/start-local-web-ng.sh
The script:
- copies
root.pem,db-client.pem, anddb-client-key.pemfrom the Docker web-ng cert mount intotmp/web-ng-docker-loop/certs/ - reads the CNPG app password from the running Docker secret without printing it
- validates the local host connection to
localhost:5455 - syncs Docker filesystem plugin/dashboard package blobs into
tmp/web-ng-docker-loop/plugin-packages/ - starts
mix phx.serverinelixir/web-ngonhttp://localhost:4000
If the app database password in Docker secrets does not match the local CNPG role, rerun once with:
.agents/skills/web-ng-docker-loop/scripts/start-local-web-ng.sh --repair-app-password
That repair path is only for the local Docker Compose stack; it uses the Docker superuser secret to reset the Docker serviceradar role to the Docker app secret.
Dashboard Package Import
After rebuilding a dashboard package, import it into the Docker-backed database without rebuilding web-ng:
.agents/skills/web-ng-docker-loop/scripts/import-dashboard-package.sh \
/home/mfreeman/src/ual-dashboard/dist/manifest.json \
/home/mfreeman/src/ual-dashboard/dist/renderer.js
This imports and enables the package through the running Docker web-ng release RPC, then prints the enabled content hash. Restart the local loop, or rerun it with the default plugin-storage sync enabled, after importing a new dashboard renderer.
Browser Checks
Use $playwright-cli for interactive inspection and screenshots:
playwright-cli open http://localhost:4000/dashboards/ual-network-map
playwright-cli snapshot
playwright-cli screenshot --filename=tmp/ual-local.png
If authentication is required, obtain the admin password from docker compose logs config-updater without writing it into committed files.
Notes
- Keep generated certs and screenshots under
tmp/; do not commit them. - Stop stale local Phoenix servers before starting a new one:
pkill -f 'mix phx.server'. - Use the Docker route (
https://192.168.2.134/...) only for final parity after local checks pass. - Run
npm run build:js && npm run build:cssinelixir/web-ng/assetsafter JS/CSS changes before browser checks.