# angular/angular-cli architecture

> Architecture diagram of the GitHub repository angular/angular-cli, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/angular/angular-cli
- Repository: https://github.com/angular/angular-cli

## Overview

Angular CLI is a monorepo of command-line tooling and supporting packages for creating, developing, building, and maintaining Angular applications. The primary user workflow is invoking `ng` to create a workspace and then run development commands; the repository also provides schematics, build/Architect services, package-manager support, and server-side rendering. The source excerpts make some internal SSR and schematics relationships visible, but do not show command dispatch or most package integrations, so those links are omitted rather than inferred.

Main entry points: [`packages/angular/ssr/src/app-engine.ts`](https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/src/app-engine.ts) (SSR app engine), [`packages/angular/ssr/src/app.ts`](https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/src/app.ts) (Server application), [`packages/angular/cli/src/package-managers/package-manager-descriptor.ts`](https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/package-managers/package-manager-descriptor.ts) (Manager descriptors), [`packages/angular/ssr/node/src/app-engine.ts`](https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/node/src/app-engine.ts) (Node engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and workspace"]
  node_cli["Angular CLI<br/>[ng.js]"]
  node_commands["CLI commands"]
  node_command_runner["Command runner<br/>[command-runner.ts]"]
end

subgraph group_schematics["Project scaffolding"]
  node_schematic_cmd["Schematic command"]
  node_schematic_host["Schematic host"]
  node_schematic_engine["Schematic engine<br/>[engine.ts]"]
  node_fs_host["Filesystem host"]
end

subgraph group_build["Build execution"]
  node_architect["Architect<br/>[architect.ts]"]
  node_builders["Build Angular"]
end

subgraph group_ssr["Server rendering"]
  node_app_engine["SSR app engine<br/>[app-engine.ts]"]
  node_server_app["Server application<br/>[app.ts]"]
  node_routes["Server routes<br/>[ng-routes.ts]"]
  node_manifest["App manifest<br/>[manifest.ts]"]
  node_node_engine["Node engine<br/>[app-engine.ts]"]
  node_common_engine["Common renderer<br/>[common-engine.ts]"]
end

subgraph group_packages["Package management"]
  node_package_manager["Package manager<br/>[package-manager.ts]"]
  node_manager_descriptor["Manager descriptors"]
  node_package_metadata["Package metadata"]
  node_manager_parsers["Output parsers<br/>[parsers.ts]"]
end

node_user(("Developer"))

node_user -->|"invokes"| node_cli
node_cli -.->|"offers"| node_commands
node_schematic_cmd -->|"uses"| node_schematic_host
node_schematic_host -->|"creates"| node_schematic_engine
node_fs_host -->|"uses API"| node_schematic_engine
node_architect -.->|"runs targets"| node_builders
node_node_engine -->|"delegates"| node_app_engine
node_node_engine -.->|"renders via"| node_common_engine
node_app_engine -->|"reads"| node_manifest
node_app_engine -.->|"dispatches"| node_server_app
node_server_app -->|"reads"| node_manifest
node_server_app -->|"matches routes"| node_routes
node_package_manager -->|"uses"| node_manager_descriptor
node_package_manager -->|"resolves"| node_package_metadata
node_manager_descriptor -->|"parses as"| node_package_metadata
node_manager_descriptor -->|"configures"| node_manager_parsers

click node_cli "https://github.com/angular/angular-cli/blob/main/packages/angular/cli/bin/ng.js"
click node_commands "https://github.com/angular/angular-cli/tree/main/packages/angular/cli/src/commands"
click node_command_runner "https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/command-builder/command-runner.ts"
click node_schematic_cmd "https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/command-builder/schematics-command-module.ts"
click node_schematic_host "https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/command-builder/utilities/schematic-engine-host.ts"
click node_schematic_engine "https://github.com/angular/angular-cli/blob/main/packages/angular_devkit/schematics/src/engine/engine.ts"
click node_fs_host "https://github.com/angular/angular-cli/blob/main/packages/angular_devkit/schematics/tools/file-system-engine-host-base.ts"
click node_architect "https://github.com/angular/angular-cli/blob/main/packages/angular_devkit/architect/src/architect.ts"
click node_builders "https://github.com/angular/angular-cli/tree/main/packages/angular_devkit/build_angular/src/builders"
click node_app_engine "https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/src/app-engine.ts"
click node_server_app "https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/src/app.ts"
click node_routes "https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/src/routes/ng-routes.ts"
click node_manifest "https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/src/manifest.ts"
click node_node_engine "https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/node/src/app-engine.ts"
click node_common_engine "https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/node/src/common-engine/common-engine.ts"
click node_package_manager "https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/package-managers/package-manager.ts"
click node_manager_descriptor "https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/package-managers/package-manager-descriptor.ts"
click node_package_metadata "https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/package-managers/package-metadata.ts"
click node_manager_parsers "https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/package-managers/parsers.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_commands,node_command_runner toneBlue
class node_schematic_cmd,node_schematic_host,node_schematic_engine,node_fs_host toneAmber
class node_architect,node_builders toneMint
class node_app_engine,node_server_app,node_routes,node_manifest,node_node_engine,node_common_engine toneRose
class node_package_manager,node_manager_descriptor,node_package_metadata,node_manager_parsers,node_user toneIndigo
```

## Components

### CLI and workspace

- [Angular CLI](https://github.com/angular/angular-cli/blob/main/packages/angular/cli/bin/ng.js): `packages/angular/cli/bin/ng.js`
- [CLI commands](https://github.com/angular/angular-cli/tree/main/packages/angular/cli/src/commands): `packages/angular/cli/src/commands`
- [Command runner](https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/command-builder/command-runner.ts): `packages/angular/cli/src/command-builder/command-runner.ts`

### Project scaffolding

- [Schematic command](https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/command-builder/schematics-command-module.ts): `packages/angular/cli/src/command-builder/schematics-command-module.ts`
- [Schematic host](https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/command-builder/utilities/schematic-engine-host.ts): `packages/angular/cli/src/command-builder/utilities/schematic-engine-host.ts`
- [Schematic engine](https://github.com/angular/angular-cli/blob/main/packages/angular_devkit/schematics/src/engine/engine.ts): `packages/angular_devkit/schematics/src/engine/engine.ts`
- [Filesystem host](https://github.com/angular/angular-cli/blob/main/packages/angular_devkit/schematics/tools/file-system-engine-host-base.ts): `packages/angular_devkit/schematics/tools/file-system-engine-host-base.ts`

### Build execution

- [Architect](https://github.com/angular/angular-cli/blob/main/packages/angular_devkit/architect/src/architect.ts): `packages/angular_devkit/architect/src/architect.ts`
- [Build Angular](https://github.com/angular/angular-cli/tree/main/packages/angular_devkit/build_angular/src/builders): `packages/angular_devkit/build_angular/src/builders`

### Server rendering

- [SSR app engine](https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/src/app-engine.ts): `packages/angular/ssr/src/app-engine.ts`
- [Server application](https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/src/app.ts): `packages/angular/ssr/src/app.ts`
- [Server routes](https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/src/routes/ng-routes.ts): `packages/angular/ssr/src/routes/ng-routes.ts`
- [App manifest](https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/src/manifest.ts): `packages/angular/ssr/src/manifest.ts`
- [Node engine](https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/node/src/app-engine.ts): `packages/angular/ssr/node/src/app-engine.ts`
- [Common renderer](https://github.com/angular/angular-cli/blob/main/packages/angular/ssr/node/src/common-engine/common-engine.ts): `packages/angular/ssr/node/src/common-engine/common-engine.ts`

### Package management

- [Package manager](https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/package-managers/package-manager.ts): `packages/angular/cli/src/package-managers/package-manager.ts`
- [Manager descriptors](https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/package-managers/package-manager-descriptor.ts): `packages/angular/cli/src/package-managers/package-manager-descriptor.ts`
- [Package metadata](https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/package-managers/package-metadata.ts): `packages/angular/cli/src/package-managers/package-metadata.ts`
- [Output parsers](https://github.com/angular/angular-cli/blob/main/packages/angular/cli/src/package-managers/parsers.ts): `packages/angular/cli/src/package-managers/parsers.ts`

### Other components

- **Developer**

## Connections

- Developer → Angular CLI: invokes (evidence: `README.md`)
- Angular CLI → CLI commands: offers
- Schematic command → Schematic host: uses (evidence: `packages/angular/cli/src/command-builder/utilities/schematic-engine-host.ts`)
- Schematic host → Schematic engine: creates (evidence: `packages/angular/cli/src/command-builder/utilities/schematic-engine-host.ts`)
- Filesystem host → Schematic engine: uses API (evidence: `packages/angular_devkit/schematics/tools/file-system-engine-host-base.ts`)
- Architect → Build Angular: runs targets
- Node engine → SSR app engine: delegates (evidence: `packages/angular/ssr/node/src/app-engine.ts`)
- Node engine → Common renderer: renders via
- SSR app engine → App manifest: reads (evidence: `packages/angular/ssr/src/app-engine.ts`)
- SSR app engine → Server application: dispatches (evidence: `packages/angular/ssr/src/app-engine.ts`)
- Server application → App manifest: reads (evidence: `packages/angular/ssr/src/app.ts`)
- Server application → Server routes: matches routes (evidence: `packages/angular/ssr/src/app.ts`)
- Package manager → Manager descriptors: uses (evidence: `packages/angular/cli/src/package-managers/package-manager.ts`)
- Package manager → Package metadata: resolves (evidence: `packages/angular/cli/src/package-managers/package-manager.ts`)
- Manager descriptors → Package metadata: parses as (evidence: `packages/angular/cli/src/package-managers/package-manager-descriptor.ts`)
- Manager descriptors → Output parsers: configures (evidence: `packages/angular/cli/src/package-managers/package-manager-descriptor.ts`)
