zitadel/apps/login/AGENTS.md

ZITADEL Login App Guide for AI Agents

Context

The Login App (apps/login) provides the user interface for authentication flows (Login, Register, MFA, etc.). It is built with Next.js and React.

Key Technology

• Framework: Next.js (React).
• Styling: TailwindCSS, configured via apps/login/tailwind.config.mjs.
• Data Fetching: Primarily server-side interaction with ZITADEL APIs via @zitadel/client or direct gRPC calls where applicable.
• Language: TypeScript.

Architecture & Conventions

• Routing: Uses the Next.js App Router (routes are defined under src/app/).
• Composability: Components should be small and reusable.
• State: Critical authentication state is often managed via URL parameters (Auth Requests) and cookies/sessions.
• Scope Rule: For shared API typings and client behavior, also read packages/AGENTS.md and proto/AGENTS.md.

Verified Nx Targets

• Dev Server: pnpm nx run @zitadel/login:dev
• Build: pnpm nx run @zitadel/login:build
• Lint: pnpm nx run @zitadel/login:lint
• Test (all): pnpm nx run @zitadel/login:test
• Test (unit): pnpm nx run @zitadel/login:test-unit
• Test (integration): pnpm nx run @zitadel/login:test-integration