feat: improve Next.js auth proof flow

[fforootd]

Summary

• Scaffold a starter home page plus login, register, and profile links for fresh Next.js apps.
• Tighten setup guidance to point at the local server, preserve framework-specific retries, and require a browser proof of register/logout/login.
• Update journey helpers, CLI docs, and component hooks so automation can verify the signed-in profile state reliably.

Testing

• Unit tests updated for setup guidance, Next patch planning, and renderer output.
• Integration coverage updated for the Next setup flow and scaffolded file contents.
• Playwright journey coverage updated to prefer visible action targets and to verify the auth flow end to end.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
nextgen	Ready	Preview, Comment	Jun 15, 2026 9:55pm

[Copilot]

Pull request overview

This PR strengthens the Next.js setup scaffolds and automation/journey validation by adding a starter auth home page, improving login/register/profile proof flows, and extending component rendering copy/hooks so agents can reliably verify end-to-end auth state in a real browser.

Changes:

• Extend the Next.js scaffold to include an auth home page and a profile page that proves session state via /__nextgen/sessions/me.
• Update CLI setup guidance, docs, and journey automation to require a visible register → logout → login → “Signed in” profile proof.
• Add date-of-birth placeholder/help copy support to the default Liquid template and document stable test hooks.

Reviewed changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
packages/components/src/orchestrator/locales/en.ts	Adds date-of-birth placeholder/help strings for Liquid-rendered forms.
packages/components/src/orchestrator/liquid.spec.ts	Updates Liquid template tests to cover date-of-birth placeholder/help rendering.
packages/components/README.md	Documents stable test hooks (data-testid) for automation against default templates.
my-app/zitadel.json	Example Zitadel project config for a Next scaffold (issuer/server/framework).
my-app/tsconfig.json	Example Next/TS config for the scaffolded app.
my-app/README.md	Example app README (create-next-app baseline).
my-app/public/window.svg	Example scaffold static asset.
my-app/public/vercel.svg	Example scaffold static asset.
my-app/public/next.svg	Example scaffold static asset.
my-app/public/globe.svg	Example scaffold static asset.
my-app/public/file.svg	Example scaffold static asset.
my-app/proxy.ts	Next 16+ request boundary proxy using nextgenMiddleware and protected /profile.
my-app/postcss.config.mjs	Tailwind/PostCSS scaffold config.
my-app/package.json	Example scaffold dependencies/scripts for Next + sdk-next.
my-app/next.config.ts	Example Next config placeholder for scaffold.
my-app/eslint.config.mjs	Scaffold ESLint config aligned with Next presets.
my-app/custom-elements.d.ts	Scaffolded JSX typings for zitadel-login / zitadel-logout custom elements.
my-app/CLAUDE.md	Points local agent instructions at repo-level AGENTS.md.
my-app/app/register/page.tsx	Scaffolded register page using <zitadel-login purpose="register">.
my-app/app/profile/page.tsx	Scaffolded profile page that fetches /__nextgen/sessions/me and renders proof state.
my-app/app/page.tsx	Scaffolded auth home page linking to login/register/profile.
my-app/app/login/page.tsx	Scaffolded login page using <zitadel-login purpose="login">.
my-app/app/layout.tsx	Base app layout (fonts/metadata) for example scaffold.
my-app/app/globals.css	Base Tailwind/global CSS scaffold.
my-app/AGENTS.md	Example app agent guidance snippet for Next.
my-app/.zitadel/state.json	Empty sync state scaffold under .zitadel/.
my-app/.gitignore	Scaffold ignore rules incl. .zitadel/local and .zitadel/secret.
my-app/.env.example	Scaffold env template including Zitadel vars and NEXT_PUBLIC_ZITADEL_PROJECT_ID.
docs/quick-start/index.md	Updates quick-start to require browser proof after setup.
apps/cli/tests/unit/lib/orca/patchers/rule/next/index.test.ts	Updates Next patcher unit tests for new home-page handling and nav expectations.
apps/cli/tests/unit/commands/setup/install.test.ts	Asserts new “browser proof” guidance in setup next actions.
apps/cli/tests/unit/commands/setup/index.test.ts	Adds/updates setup pre-flight guidance assertions (framework preserved in local retry).
apps/cli/tests/integration/setup-next.test.ts	Extends integration coverage to validate scaffolded file contents and proof guidance.
apps/cli/src/lib/orca/patchers/types.ts	Adds scaffoldedFramework to patch context.
apps/cli/src/lib/orca/patchers/rule/next/renderers/react/index.ts	Updates generated Next React templates (nav link + profile proof fetch).
apps/cli/src/lib/orca/patchers/rule/next/index.ts	Adds home page into Next patcher file set and conditionally overwrites starter page on fresh scaffolds.
apps/cli/src/commands/setup/install.ts	Adds explicit browser auth proof instructions to setup outcomes.
apps/cli/src/commands/setup/index.ts	Improves local-server-not-running guidance to preserve framework in retry commands; plumbs scaffold state.
apps/cli/SKILLS.md	Updates agent contract: require visible browser auth proof + stable DOM hooks.
apps/cli/README.md	Updates CLI docs to reflect new scaffold pages and proof requirements.
apps/cli-journey-e2e/src/user-journey.spec.ts	Makes action clicking prefer visible, stable test hook targets to reduce flakiness.
.changeset/lean-agent-auth-proof.md	Changeset for @zitadel/cli (minor) and @zitadel/components (patch).