Back to docs

Testing

title: Testing

--- title: Testing description: Testing strategy for workflows and domains. ---

Testing

Ekairos testing focuses on long running workflows and domain aware UI flows.

Packages

  • @ekairos/testing: shared test helpers and fixtures.

Workflow tests

Workflows are executed using "use workflow" and can be run in E2E mode via Playwright or CLI runners.

Domain integrity tests

Domain integrity tests validate:

  • Domain schema composition.
  • Domain context output.
  • Domain API exposure via the well known endpoint.
  • Query execution via InstaQL.

E2E patterns

Common patterns used in platform tests:

  • Seed an org db and push schema.
  • Start the app server.
  • Use Playwright to authenticate (Clerk) and navigate UI.
  • Capture screenshots as artifacts.
  • Query domain API to validate backend state.

Long running test runner

@ekairos/testing is designed to support long running workflows and step by step inspection. The workflow runner and the Playwright runner can be used together when needed.