End-to-end tests for StreamKit using Playwright.

• Bun 1.3.5+
• Rust 1.95.0+ (for building skit)
• Built UI (cd ui && bun install && bun run build or just build-ui)
• Built skit binary (cargo build -p streamkit-server --bin skit)

# Install dependencies and Playwright browsers
just install-e2e
just install-playwright

# Run tests (automatically starts server)
just e2e

# Or run directly from e2e directory
cd e2e
bun install
bunx playwright install chromium
bun run test

If you already have a StreamKit server running:

E2E_BASE_URL=http://localhost:4545 bun run test:only

# Or via justfile
just e2e-external http://localhost:4545

If the external server has built-in auth enabled, the auth E2E tests need an admin token.

Options:

• Set E2E_ADMIN_TOKEN explicitly, or
• Set E2E_AUTH_STATE_DIR to the server's auth state directory (the tests will read admin.token from it), or
• Use the default local state dir .streamkit/auth (the tests will try ../.streamkit/auth/admin.token when running from e2e/).

To test against the Vite development server (useful for debugging UI changes):

# Terminal 1: Start skit backend
cargo run -p streamkit-server --bin skit -- serve

# Terminal 2: Start Vite dev server
cd ui && bun run dev

# Terminal 3: Run E2E tests against Vite
just e2e-external http://localhost:3045

The Vite dev server proxies /api/* and /healthz requests to the skit backend (default 127.0.0.1:4545). This is primarily for Playwright’s direct API calls when E2E_BASE_URL points at the Vite server; the UI itself still talks directly to the backend in development (via import.meta.env.VITE_API_BASE).

Both servers must be running for tests to pass.

• tests/design.spec.ts - Design view tests (canvas, samples, YAML editor)
• tests/monitor.spec.ts - Monitor view tests (session lifecycle)
• tests/auth.spec.ts - Built-in auth flow tests (login + cookie + logout)

When E2E_BASE_URL is not set, the test harness (src/harness/run.ts):

1. Finds a free port
2. Starts target/debug/skit serve with SK_SERVER__ADDRESS=127.0.0.1:<port>
3. Polls /healthz until server is ready (30s timeout)
4. Runs all Playwright tests
5. Stops the server

Environment variables set by harness:

• SK_SERVER__ADDRESS - Bind address
• SK_LOG__FILE_ENABLE=false - Disable file logging
• RUST_LOG=warn - Reduce log noise

To run the E2E suite with StreamKit's built-in auth enabled:

just e2e-auth

# Or directly:
cd e2e
E2E_AUTH=1 bun run test

When E2E_AUTH=1 (or E2E_AUTH_MODE=enabled) is set, the harness:

• Starts skit with SK_AUTH__MODE=enabled
• Uses an isolated auth state directory under target/
• Reads the generated bootstrap token from admin.token and exposes it to tests as E2E_ADMIN_TOKEN

Set E2E_KEEP_AUTH_STATE=1 to keep the temporary auth state directory for debugging.

# Run with debug mode (shows server output)
DEBUG=1 bun run test

# Run single test file
bun run test -- tests/design.spec.ts

# Run with trace viewer on failure
bun run test -- --trace on

# Run specific test by name
bun run test -- -g "loads with all main panes"

Tests run automatically in CI via .github/workflows/e2e.yml. On failure, playwright-report/ and test-results/ are uploaded as artifacts.

1. Create a new spec file in tests/ directory
2. Use data-testid attributes for stable element selection
3. Prefer role/name selectors for accessible elements
4. Avoid arbitrary waits; use Playwright's built-in assertions

Example:

import { test, expect } from '@playwright/test';

test('my new test', async ({ page }) => {
  await page.goto('/my-route');
  await expect(page.getByTestId('my-element')).toBeVisible();
});