smoke-test

Smoke Test

Navigate key application routes using Playwright and verify they render without errors.

Arguments

• --frontend-only — Only test frontend routes (skip API health checks)
• --api-only — Only test API health endpoints
• --interactive — Run interactive CRUD flows after route testing (creates test data)
• --screenshot — Take screenshots of each page (saved to /tmp/smoke-test/)
• {url} — Test a specific URL instead of the default routes

Configuration

Read cloudstack.json from the project root at the start of execution. Extract:

• FRONTEND_PATH = frontend.path (default: web)
• DEV_PORT = frontend.devPort (default: 5173)

Also extract:

• API_PORT = backend.devPort (default: 5000)
• ORCHESTRATOR = localDev.orchestrator (default: none) — e.g., aspire, docker-compose, none
• ORCHESTRATOR_PORT = localDev.orchestratorPort (default: none)

If cloudstack.json does not exist, auto-detect by checking package.json dependencies.

Auth Configuration

Check cloudstack.json for localDev.authConfig. If present, use it. Otherwise, detect the auth store pattern from the codebase (see screenshot skill for details).

Prerequisites

The local environment must be running. If not, suggest starting the dev server first.

Process

Playwright tools are mcp__plugin_react-developer_playwright__<tool>; short names below (e.g. browser_navigate) refer to those.

Step 1: Verify Services Are Up

Check that the expected ports are responding before running browser tests:

# Check API
curl -sf http://localhost:{API_PORT}/health/live > /dev/null 2>&1 && echo "API: UP" || echo "API: DOWN"

# Check Frontend
curl -sf http://localhost:{DEV_PORT} > /dev/null 2>&1 && echo "Frontend: UP" || echo "Frontend: DOWN"

If ORCHESTRATOR is set (e.g., aspire, docker-compose), also check the orchestrator dashboard:

# Only if ORCHESTRATOR_PORT is configured
curl -sf http://localhost:{ORCHESTRATOR_PORT} -k > /dev/null 2>&1 && echo "Orchestrator: UP" || echo "Orchestrator: DOWN"