# parcel-bundler/parcel architecture

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

- Interactive diagram: https://gitdiagram.com/parcel-bundler/parcel
- Repository: https://github.com/parcel-bundler/parcel

## Overview

Parcel is a zero-configuration web build tool. A user supplies project entries and build options; Parcel resolves dependencies, transforms assets, constructs bundles, packages and optimizes outputs, then reports results or serves them during development. Its plugin configuration selects resolvers, transformers, bundlers, namers, packagers, optimizers, compressors, and reporters. The graph combines documented product capabilities with source-index references and sampled calls; several plugin-stage links are documented or architectural, not verified in the sampled excerpts.

Main entry points: [`packages/core/core/src/Parcel.js`](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/Parcel.js) (Build orchestrator), [`packages/core/core/src/PackagerRunner.js`](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/PackagerRunner.js) (Packager runner), [`packages/core/workers/src/WorkerFarm.js`](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/workers/src/WorkerFarm.js) (Worker farm), [`packages/core/core/src/ParcelConfig.js`](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/ParcelConfig.js) (Plugin config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Build control"]
  node_cli["CLI<br/>[cli.js]"]
  node_parcel["Build orchestrator<br/>[Parcel.js]"]
  node_config["Plugin config<br/>[ParcelConfig.js]"]
end

subgraph group_assets["Asset processing"]
  node_assetgraph["Asset graph<br/>[AssetGraph.js]"]
  node_transform["Transformations<br/>[Transformation.js]"]
  node_resolver["Dependency resolver<br/>[lib.rs]"]
end

subgraph group_bundles["Bundle output"]
  node_bundler["Bundling<br/>[DefaultBundler.js]"]
  node_bundlegraph["Bundle graph<br/>[BundleGraph.js]"]
  node_namer["Output naming<br/>[DefaultNamer.js]"]
  node_packager["Packager runner<br/>[PackagerRunner.js]"]
  node_packagers["Format packagers"]
  node_optimizers["Optimizers"]
  node_compressors["Compressors"]
end

subgraph group_runtime["Runtime services"]
  node_cache[("Build cache<br/>[buildCache.js]")]
  node_workers["Worker farm<br/>[WorkerFarm.js]"]
  node_package_manager["Package manager"]
end

subgraph group_delivery["Developer delivery"]
  node_reporters["Reporters<br/>[ReporterRunner.js]"]
  node_devserver["Development server<br/>[Server.js]"]
  node_diagnostics["Diagnostics<br/>[diagnostic.js]"]
end

node_user(("Developer"))

node_user -.->|"starts build"| node_cli
node_cli -.->|"invokes"| node_parcel
node_parcel -.->|"builds graph"| node_assetgraph
node_assetgraph -.->|"transforms assets"| node_transform
node_transform -.->|"resolves dependencies"| node_resolver
node_parcel -.->|"dispatches work"| node_workers
node_workers -->|"runs"| node_transform
node_workers -->|"runs"| node_packager
node_workers -->|"uses graph"| node_bundlegraph
node_workers -->|"loads config"| node_config
node_parcel -.->|"loads plugins"| node_config
node_config -.->|"selects plugin"| node_bundler
node_bundler -.->|"creates bundles"| node_bundlegraph
node_bundlegraph -->|"uses asset graph"| node_assetgraph
node_packager -->|"loads config"| node_config
node_packager -->|"reads graph"| node_bundlegraph
node_packager -.->|"names outputs"| node_namer
node_packager -.->|"selects format"| node_packagers
node_packager -.->|"optimizes output"| node_optimizers
node_packager -.->|"compresses output"| node_compressors
node_parcel -.->|"caches builds"| node_cache
node_parcel -.->|"resolves plugins"| node_package_manager
node_parcel -.->|"reports events"| node_reporters
node_reporters -.->|"starts server"| node_devserver
node_reporters -.->|"formats errors"| node_diagnostics

click node_cli "https://github.com/parcel-bundler/parcel/blob/v2/packages/core/parcel/src/cli.js"
click node_parcel "https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/Parcel.js"
click node_config "https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/ParcelConfig.js"
click node_assetgraph "https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/AssetGraph.js"
click node_transform "https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/Transformation.js"
click node_resolver "https://github.com/parcel-bundler/parcel/blob/v2/crates/parcel-resolver/src/lib.rs"
click node_bundler "https://github.com/parcel-bundler/parcel/blob/v2/packages/bundlers/default/src/DefaultBundler.js"
click node_bundlegraph "https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/BundleGraph.js"
click node_namer "https://github.com/parcel-bundler/parcel/blob/v2/packages/namers/default/src/DefaultNamer.js"
click node_packager "https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/PackagerRunner.js"
click node_packagers "https://github.com/parcel-bundler/parcel/tree/v2/packages/packagers"
click node_optimizers "https://github.com/parcel-bundler/parcel/tree/v2/packages/optimizers"
click node_compressors "https://github.com/parcel-bundler/parcel/tree/v2/packages/compressors"
click node_cache "https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/buildCache.js"
click node_workers "https://github.com/parcel-bundler/parcel/blob/v2/packages/core/workers/src/WorkerFarm.js"
click node_package_manager "https://github.com/parcel-bundler/parcel/blob/v2/packages/core/package-manager/src/NodePackageManager.js"
click node_reporters "https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/ReporterRunner.js"
click node_devserver "https://github.com/parcel-bundler/parcel/blob/v2/packages/reporters/dev-server/src/Server.js"
click node_diagnostics "https://github.com/parcel-bundler/parcel/blob/v2/packages/core/diagnostic/src/diagnostic.js"

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_parcel,node_config toneBlue
class node_assetgraph,node_transform,node_resolver toneAmber
class node_bundler,node_bundlegraph,node_namer,node_packager,node_packagers,node_optimizers,node_compressors toneMint
class node_cache,node_workers,node_package_manager toneRose
class node_reporters,node_devserver,node_diagnostics,node_user toneIndigo
```

## Components

### Build control

- [CLI](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/parcel/src/cli.js): `packages/core/parcel/src/cli.js`
- [Build orchestrator](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/Parcel.js): `packages/core/core/src/Parcel.js`
- [Plugin config](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/ParcelConfig.js): `packages/core/core/src/ParcelConfig.js`

### Asset processing

- [Asset graph](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/AssetGraph.js): `packages/core/core/src/AssetGraph.js`
- [Transformations](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/Transformation.js): `packages/core/core/src/Transformation.js`
- [Dependency resolver](https://github.com/parcel-bundler/parcel/blob/v2/crates/parcel-resolver/src/lib.rs): `crates/parcel-resolver/src/lib.rs`

### Bundle output

- [Bundling](https://github.com/parcel-bundler/parcel/blob/v2/packages/bundlers/default/src/DefaultBundler.js): `packages/bundlers/default/src/DefaultBundler.js`
- [Bundle graph](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/BundleGraph.js): `packages/core/core/src/BundleGraph.js`
- [Output naming](https://github.com/parcel-bundler/parcel/blob/v2/packages/namers/default/src/DefaultNamer.js): `packages/namers/default/src/DefaultNamer.js`
- [Packager runner](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/PackagerRunner.js): `packages/core/core/src/PackagerRunner.js`
- [Format packagers](https://github.com/parcel-bundler/parcel/tree/v2/packages/packagers): `packages/packagers`
- [Optimizers](https://github.com/parcel-bundler/parcel/tree/v2/packages/optimizers): `packages/optimizers`
- [Compressors](https://github.com/parcel-bundler/parcel/tree/v2/packages/compressors): `packages/compressors`

### Runtime services

- [Build cache](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/buildCache.js): `packages/core/core/src/buildCache.js`
- [Worker farm](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/workers/src/WorkerFarm.js): `packages/core/workers/src/WorkerFarm.js`
- [Package manager](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/package-manager/src/NodePackageManager.js): `packages/core/package-manager/src/NodePackageManager.js`

### Developer delivery

- [Reporters](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/core/src/ReporterRunner.js): `packages/core/core/src/ReporterRunner.js`
- [Development server](https://github.com/parcel-bundler/parcel/blob/v2/packages/reporters/dev-server/src/Server.js): `packages/reporters/dev-server/src/Server.js`
- [Diagnostics](https://github.com/parcel-bundler/parcel/blob/v2/packages/core/diagnostic/src/diagnostic.js): `packages/core/diagnostic/src/diagnostic.js`

### Other components

- **Developer**

## Connections

- Developer → CLI: starts build (evidence: `README.md`)
- CLI → Build orchestrator: invokes
- Build orchestrator → Asset graph: builds graph
- Asset graph → Transformations: transforms assets
- Transformations → Dependency resolver: resolves dependencies
- Build orchestrator → Worker farm: dispatches work
- Worker farm → Transformations: runs
- Worker farm → Packager runner: runs
- Worker farm → Bundle graph: uses graph
- Worker farm → Plugin config: loads config
- Build orchestrator → Plugin config: loads plugins
- Plugin config → Bundling: selects plugin
- Bundling → Bundle graph: creates bundles
- Bundle graph → Asset graph: uses asset graph (evidence: `packages/core/core/src/BundleGraph.js`)
- Packager runner → Plugin config: loads config (evidence: `packages/core/core/src/PackagerRunner.js`)
- Packager runner → Bundle graph: reads graph (evidence: `packages/core/core/src/PackagerRunner.js`)
- Packager runner → Output naming: names outputs
- Packager runner → Format packagers: selects format
- Packager runner → Optimizers: optimizes output (evidence: `README.md`)
- Packager runner → Compressors: compresses output
- Build orchestrator → Build cache: caches builds (evidence: `README.md`)
- Build orchestrator → Package manager: resolves plugins
- Build orchestrator → Reporters: reports events
- Reporters → Development server: starts server
- Reporters → Diagnostics: formats errors
