How parcel-bundler/parcel works
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: Parcel.js Build orchestrator · PackagerRunner.js Packager runner · WorkerFarm.js Worker farm · ParcelConfig.js Plugin config
Components 20
Build control
- CLI
packages/core/parcel/src/cli.js - Build orchestrator
packages/core/core/src/Parcel.js - Plugin config
packages/core/core/src/ParcelConfig.js
Asset processing
- Asset graph
packages/core/core/src/AssetGraph.js - Transformations
packages/core/core/src/Transformation.js - Dependency resolver
crates/parcel-resolver/src/lib.rs
Bundle output
- Bundling
packages/bundlers/default/src/DefaultBundler.js - Bundle graph
packages/core/core/src/BundleGraph.js - Output naming
packages/namers/default/src/DefaultNamer.js - Packager runner
packages/core/core/src/PackagerRunner.js - Format packagers
packages/packagers - Optimizers
packages/optimizers - Compressors
packages/compressors
Runtime services
- Build cache
packages/core/core/src/buildCache.js - Worker farm
packages/core/workers/src/WorkerFarm.js - Package manager
packages/core/package-manager/src/NodePackageManager.js
Developer delivery
- Reporters
packages/core/core/src/ReporterRunner.js - Development server
packages/reporters/dev-server/src/Server.js - Diagnostics
packages/core/diagnostic/src/diagnostic.js
Other components
- Developer
Connections 25
- Developer → CLI: starts build
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
packages/core/core/src/BundleGraph.js - Packager runner → Plugin config: loads config
packages/core/core/src/PackagerRunner.js - Packager runner → Bundle graph: reads graph
packages/core/core/src/PackagerRunner.js - Packager runner → Output naming: names outputs
- Packager runner → Format packagers: selects format
- Packager runner → Optimizers: optimizes output
README.md - Packager runner → Compressors: compresses output
- Build orchestrator → Build cache: caches builds
README.md - Build orchestrator → Package manager: resolves plugins
- Build orchestrator → Reporters: reports events
- Reporters → Development server: starts server
- Reporters → Diagnostics: formats errors