feat: list supported frameworks in the CLI scaffold flow

[fforootd]

Summary

• Add framework discovery and selection helpers for the consumer journey scaffold path
• Update CLI setup behavior, Nuxt patching, and SDK Nuxt runtime handling to match the new flow
• Refresh journey docs, instructions, CI wiring, and the changeset for the supported-frameworks work

Testing

• Unit tests updated for framework discovery, run options, and Nuxt patching behavior
• Playwright journey coverage updated for the fresh-app consumer path

[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 8:30pm

[Copilot]

Pull request overview

This PR expands the CLI fresh-app scaffold/journey flow from “Next-only” to a supported-framework matrix, and updates the Nuxt SDK/runtime wiring and consumer-journey infrastructure to match.

Changes:

• Allow fresh scaffolding when zitadel start has already created runtime-only .zitadel/local state and a .gitignore, preserving/merging those artifacts during scaffold.
• Update Nuxt integration defaults (runtime config + protected routes) and make the Nuxt SDK read runtime config via Nuxt virtual imports (#imports).
• Convert the consumer journey runner + CI job into a framework matrix (Next, Nuxt, React, Vue, Angular) with per-framework diagnostics/output isolation.

Reviewed changes

Copilot reviewed 27 out of 28 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
README.md	Updates journey description to run setup across all supported frameworks with filtering option.
packages/sdk-nuxt/src/shims.d.ts	Adds useRuntimeConfig ambient type for Nuxt virtual imports.
packages/sdk-nuxt/src/runtime/server/handler.ts	Switches runtime-config access to #imports and keeps handler options derived from nextgen config.
packages/sdk-nuxt/package.json	Externalizes #imports in the primary tsup build to support the new import.
apps/cli/tests/unit/lib/orca/patchers/rule/nuxt/nuxt-config.test.ts	Extends Nuxt config patcher tests for nextgen.url and protectedRoutes.
apps/cli/tests/unit/lib/orca/index.test.ts	Adds coverage ensuring .gitignore is allowed/preserved when scaffolding with runtime-only state present.
apps/cli/tests/unit/commands/setup.test.ts	Adds dry-run setup fixtures asserting framework support across Next/Nuxt/React/Vue/Angular.
apps/cli/src/lib/orca/patchers/rule/nuxt/README.md	Documents new Nuxt defaults (backend URL + protected route).
apps/cli/src/lib/orca/patchers/rule/nuxt/nuxt-config.ts	Seeds nextgen.url and nextgen.protectedRoutes in Nuxt config edits.
apps/cli/src/lib/orca/index.ts	Extends fresh-scaffold target inspection + stashing/restoration to include .gitignore alongside runtime-only .zitadel.
apps/cli-journey-e2e/src/user-journey.spec.ts	Generalizes the journey spec to run against any selected framework and handles framework-specific redirects/flows.
apps/cli-journey-e2e/src/contract.spec.ts	Aligns contract assertions with new sdkPackage and framework metadata.
apps/cli-journey-e2e/scripts/run-options.test.mjs	Adds unit tests for local journey CLI option parsing.
apps/cli-journey-e2e/scripts/run-options.mjs	Introduces shared local journey arg parsing (framework selection, concurrency, etc.).
apps/cli-journey-e2e/scripts/run-local.mjs	Refactors local journey runner to execute a framework matrix in parallel with isolated ports and diagnostics.
apps/cli-journey-e2e/scripts/prepare-app.test.mjs	Updates prepare script tests for multi-framework support and generic SDK package key.
apps/cli-journey-e2e/scripts/prepare-app.mjs	Replaces Next-only prepare logic with framework-aware setup (including --dev-port) and package-resolution checks.
apps/cli-journey-e2e/scripts/local-registry.mjs	Improves HTTP readiness diagnostics by including response bodies for non-OK statuses.
apps/cli-journey-e2e/scripts/frameworks.test.mjs	Adds tests for the framework registry and helpers.
apps/cli-journey-e2e/scripts/frameworks.mjs	Defines the framework registry (ids, sdk dirs, dev args, expectations) and URL→port helper.
apps/cli-journey-e2e/README.md	Updates documentation to describe the framework-matrix journey runner and options.
apps/cli-journey-e2e/playwright.config.mts	Supports per-framework Playwright output/report directories via env overrides.
apps/cli-journey-e2e/package.json	Updates prepare script entrypoint name to the new framework-aware script.
apps/cli-journey-e2e/AGENTS.md	Updates agent guidance to reflect multi-framework fresh-app journey requirements.
AGENTS.md	Updates repo-level guidance describing the consumer journey as multi-framework.
.github/workflows/ci.yml	Runs consumer-journey-e2e as a framework matrix and isolates logs/artifacts per framework.
.github/instructions/consumer-journey.instructions.md	Updates journey instructions to reference multi-framework setup and artifacts.
.changeset/fix-start-then-setup-scaffold.md	Adds changeset for CLI + sdk-nuxt behavior changes tied to scaffold/runtime-config handling.