e2e-test-service-management

Start, stop, and monitor PostgreSQL, Rust backend, and Next.js frontend services for E2E testing.

2.1k|244|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/raphaelmansuy/edgequake --skill e2e-test-service-management-raphaelmansuy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: e2e-test-service-management
Source: https://github.com/raphaelmansuy/edgequake/tree/main/.github/skills/e2e-test-service-management
Command: npx skills add https://github.com/raphaelmansuy/edgequake --skill e2e-test-service-management-raphaelmansuy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running Playwright E2E tests against EdgeQuake requires three coordinated services (PostgreSQL, Rust backend, Next.js frontend), and manually starting, verifying, and stopping them is error-prone and slow. This Skill provides a single operational reference for managing the full service lifecycle during interactive and automated testing. ## Core Features & Use Cases - Service Lifecycle Management: Start, stop, restart, and check status of all three services via Make commands or the bundled test-services.sh utility script. - Health Checks & Readiness Waits: Verify frontend, backend, and database availability before running tests to prevent flaky failures. - Log Monitoring & Troubleshooting: Stream backend, database, and frontend logs, plus guidance for common issues like port conflicts and stale database state. - Use Case: Before running a Playwright suite, start the stack with make dev, confirm all services report healthy with make status, execute the tests, then run make stop to free ports. ## Quick Start Ask the assistant to start all EdgeQuake services, wait until they are healthy, and then run the Playwright E2E test suite.

Frequently Asked Questions about e2e-test-service-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start all services for Playwright E2E testing?

Run make dev to start PostgreSQL, the Rust backend on port 8080, and the Next.js frontend on port 3000. Then run make status to confirm all three services report healthy before executing tests.

How do I run Playwright tests against a local backend?

Start the stack with make dev, then run pnpm exec playwright test from the edgequake_webui directory. Use --headed or --debug flags to inspect failures interactively in the browser.

Can I test the backend without a real OpenAI API key?

Yes, the backend uses a mock LLM provider by default, so tests run fast and free. Set the OPENAI_API_KEY environment variable only when you need to test against the real OpenAI API.

Why do my E2E tests fail right after starting services?

Tests fail when services have not finished initializing. Use make status or the test-services.sh wait-ready command to block until the frontend, backend, and database all respond before running tests.

How do I fix port already in use errors on 3000 or 8080?

Run make stop to shut down existing services, then restart with make dev. Alternatively, override the ports through environment variables or the .env.local file.

How do I reset the PostgreSQL database between test runs?

Run make db-reset to delete all data and reinitialize the database with pgvector and Apache AGE extensions. This gives each test cycle a clean, isolated state.