cypress-io/cypress

The system spans a user-Node CLI, an Electron main process, a configuration/plugin child process, and browser bundles. The application exposes GraphQL and browser communication services while coordinating projects and network interception. Distribution includes an npm module and platform-specific desktop binaries, with separate build and release machinery.

• Yarn workspaces cover cli, packages, npm, tooling, system-tests, and scripts; Lerna uses the same package layout and selects Yarn as its npm client.
  package.json#L235-253lerna.json#L1-12
• The executable entry calls CLI.init(); the module entry exports open, run, cli, defineConfig, and defineComponentFramework.
  cli/lib/bin/cypress.ts#L1-5cli/lib/index.ts#L43-56
• Server startup installs the require hook before loading start-cypress; runElectron dispatches directly to modes when already inside Electron and otherwise opens an Electron child.
  packages/server/index.js#L8-30packages/server/lib/cypress.ts#L93-125
• ProjectConfigIpc forks configuration code with cwd at the config file's directory and execPath set to the resolved user Node; cli/package.json supports Node ^22, ^24, or >=26.
  packages/data-context/src/data/ProjectConfigIpc.ts#L308-324packages/data-context/src/data/ProjectConfigIpc.ts#L410-416cli/package.json#L125-127
• The Vue application uses generated hash-history routes; its state backend builds a Nexus GraphQL schema with DataContext as context and a wrapped remote schema.
  packages/app/src/router/router.ts#L1-22packages/app/src/router/router.ts#L70-78packages/data-context/graphql/schema.ts#L14-37
• createProxyRuntime and createCdpFetchRuntime compose interception transports; both receive the server-owned NetStubbingState rather than creating independent route state.
  packages/server/lib/network-runtime.ts#L31-43packages/server/lib/network-runtime.ts#L104-124packages/server/lib/network-runtime.ts#L174-200
• Inspected local storage includes versioned binary caches, project/global state.json files, and PID-named interactive-session records; these serve different lifecycle owners.
  cli/lib/tasks/state.ts#L51-60packages/server/lib/saved_state.ts#L17-50packages/cypress-sessions/lib/index.ts#L65-85
• Root build runs the Lerna build, Electron binary build, and CLI build; release documentation distinguishes independently published @cypress packages from desktop binaries promoted in S3 and the cypress npm artifact.
  package.json#L8-20guides/release-process.md#L3-7guides/release-process.md#L95-109