zitadel/tests/functional-ui/AGENTS.md

ZITADEL Functional UI Test Guide for AI Agents

Context

tests/functional-ui contains Cypress-based end-to-end tests focused on Management Console flows against a running ZITADEL API.

Verified Nx Targets

• Open interactive Cypress runner: pnpm nx run @zitadel/functional-ui:open
• Run test suite: pnpm nx run @zitadel/functional-ui:test
• Start test DB only: pnpm nx run @zitadel/functional-ui:run-db
• Start test API only: pnpm nx run @zitadel/functional-ui:run-api
• Stop test infra: pnpm nx run @zitadel/functional-ui:stop

Workflow Notes

• Functional UI tests are the primary test path for Console user journeys, since @zitadel/console has no Nx test target.
• These tests depend on API build/run orchestration; avoid changing API startup assumptions without updating this suite.