Parcel Documentation

Getting started

Learn how to start a new project, or migrate an existing project to Parcel 3.

Building a webapp with Parcel

Learn how to set up a new web application from scratch with Parcel.

Building a library with Parcel

Learn how to set up a Parcel to build a JavaScript library.

Migrate an existing project from Parcel 2 to Parcel 3.

Features

Learn about Parcel's core features.

Learn about Parcel's dev server, hot reloading, HTTPS, and more.

How to use dynamic imports and Parcel's automatic shared bundles.

How dependencies are resolved, url schemes, aliases, and more.

Bundle Inlining

How to inline the compiled contents of one bundle inside another.

How to compile your source code for multiple targets.

Minification, tree shaking, content hashing, bundle analysis, and more.

Dig into the details of how Parcel's tree shaking works.

Using Node.js features like environment variables and builtin module polyfills.

A reference for all of the options available in the Parcel CLI.

Run JavaScript functions at build time and inline the results into your bundle.

Overriding and extending Parcel's defaults using plugins.

Languages and Frameworks

Learn how to use the most common languages and frameworks with Parcel. See the side navigation for even more.

The entry of most Parcel apps. From here, you can reference scripts, styles, images, and more.

Using ES modules and CommonJS, setting up transpilation, JSX, workers, and more.

Using CSS with Parcel, including dependencies, CSS modules, PostCSS, and more.

Referencing SVG from HTML, CSS, JavaScript, and JSX, including scripts and styles, and more.

Using TypeScript with Parcel, including transpilation, tsconfig.json, and more.

Resizing, converting, and optimizing images.

Using React with Parcel, including Fast Refresh, styling, images, code splitting, and more.

Writing documentation with Markdown and JSX, including code blocks and Fast Refresh.

Plugin System

Learn how to customize and extend Parcel's defaults with your own plugins.

Concepts

An overview of Parcel's architecture and core data structures.

Authoring Plugins

An introduction to Parcel's Plugin APIs, and a guide to publishing a plugin package.

Write high performance plugins in Rust, Go, Swift, or C.

How to emit errors and logs using Parcel's unified diagnostics format.

How to work with source maps in your plugin.

Plugin Types

Compile individual source files and extract dependencies.

Resolve a dependency to a file path or virtual module.

Determine the name of an output file.

Minify, optimize, and transform output files.

Receive events on build progress and completion.

Share Parcel configuration between projects.