Skip to content

docs: clarify webpack loader execution order (right-to-left) #8136

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
alexander-akait merged 5 commits into from
Apr 17, 2026
Merged

docs: clarify webpack loader execution order (right-to-left) #8136

Changes from 3 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
bef3407
docs: clarify webpack loader execution order (right-to-left)
mr-baraiya Mar 29, 2026
d128213
docs: clarify loader execution order and update example
mr-baraiya Mar 30, 2026
b19136c
docs: clarify loader execution order and update example to use postcs…
mr-baraiya Apr 16, 2026
df6994c
docs: clarify loader execution order, update example, and improve exp…
mr-baraiya Apr 16, 2026
33d38e4
docs: fix mdx syntax and update loader example structure
mr-baraiya Apr 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 10 additions & 5 deletions src/content/guides/asset-management.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ contributors:
- astonizer
- snitin315
- Brennvo
- mr-baraiya
---

If you've been following the guides from the start, you will now have a small project that shows "Hello webpack". Now let's try to incorporate some other assets, like images, to see how they can be handled.
Expand Down Expand Up @@ -95,15 +96,19 @@ npm install --save-dev style-loader css-loader
};
```

Copy link

Copilot AI Apr 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section shows test: /\.css$/i in the config diff, but the explanatory sentence about test being a regex that selects which files the rule applies to was removed. Consider reintroducing a short explanation (e.g., that this rule targets .css files) so the example is self-contained for readers unfamiliar with webpack’s module.rules format.

Suggested change
In this rule, `test: /\.css$/i` is a regular expression that tells webpack to apply the rule to `.css` files.

Copilot uses AI. Check for mistakes.
Module loaders can be chained. Each loader in the chain applies transformations to the processed resource. A chain is executed in reverse order. The first loader passes its result (resource with applied transformations) to the next one, and so forth. Finally, webpack expects JavaScript to be returned by the last loader in the chain.
Loaders in webpack are executed from **right to left** (i.e., from last to first in the `use` array).

Copy link

Copilot AI Apr 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section explains the general right-to-left execution order, but it no longer explicitly ties that back to the earlier use: ['style-loader', 'css-loader'] example (i.e., that css-loader runs first and style-loader runs last). Adding one short sentence that applies the rule to the preceding config would better resolve the original confusion this PR is addressing.

Copilot uses AI. Check for mistakes.
The above order of loaders should be maintained: [`'style-loader'`](/loaders/style-loader) comes first and followed by [`'css-loader'`](/loaders/css-loader). If this convention is not followed, webpack is likely to throw errors.
For example:

T> webpack uses a regular expression to determine which files it should look for and serve to a specific loader. In this case, any file that ends with `.css` will be served to the `style-loader` and the `css-loader`.
```js
use: ["postcss-loader", "sass-loader"];
Copy link

Copilot AI Apr 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The new use snippet is not valid in a typical webpack.config.js object literal (; and double-quotes), and it’s inconsistent with the surrounding examples that use single quotes and a trailing comma. Consider changing it to a config-style property (single quotes, trailing comma) so readers can copy/paste it directly.

Suggested change
use: ["postcss-loader", "sass-loader"];
use: ['postcss-loader', 'sass-loader'],

Copilot uses AI. Check for mistakes.
```

Here, `sass-loader` runs first and compiles Sass into CSS, followed by `postcss-loader`, which applies further transformations.

This enables you to `import './style.css'` into the file that depends on that styling. Now, when that module is run, a `<style>` tag with the stringified css will be inserted into the `<head>` of your html file.
So even though `postcss-loader` appears before `sass-loader` in the array, the execution happens in reverse order.

Let's try it out by adding a new `style.css` file to our project and import it in our `index.js`:
If this order is not maintained, webpack may throw errors.

**project**

Expand Down
Loading