PHPackages                             castiron/webpackassets-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. castiron/webpackassets-plugin

ActiveOctober-plugin[Utility & Helpers](/categories/utility)

castiron/webpackassets-plugin
=============================

Webpack hashed files in October CMS

2.0.3(3y ago)65.1k1[1 issues](https://github.com/castiron/webpackassets-plugin/issues)MITPHPPHP >=5.4CI failing

Since May 18Pushed 3w ago10 watchersCompare

[ Source](https://github.com/castiron/webpackassets-plugin)[ Packagist](https://packagist.org/packages/castiron/webpackassets-plugin)[ Docs](https://github.com/castiron/webpackassets-plugin)[ RSS](/packages/castiron-webpackassets-plugin/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependencies (1)Versions (14)Used By (0)

Webpack Assets in October CMS
-----------------------------

[](#webpack-assets-in-october-cms)

This plugin for OctoberCMS works in tandem with the node package `webpack-assets-manifest`() to include CSS, JS, and font assets in your site based on a JSON manifest file written to your assets directory. This will allow you to use hashed file names in your built files, and let October pick up the paths effortlessly.

In non-development environments (when the APP\_ENV environment variable doesn't equal "dev") these paths get cached so the JSON file isn't read on every request. This cache should be cleared as a part of the deploy process by running `php artisan cache:clear`.

### Installation

[](#installation)

```
composer require castiron/webpackassets-plugin

```

### Quick start

[](#quick-start)

This plugin provides a component called `webpackAssets`. Include the component in your view and then use the following to include the js/css/fonts (WOFF2 only) in your template (e.g. in a partial, layout, etc.):

```
[webpackAssets]
==

{{ webpackAssets.tag('unhashed_filename.woff2') | raw }}

{{ webpackAssets.tag('unhashed_filename.css') | raw }}
```

```
[webpackAssets]
==

{{ webpackAssets.tag('unhashed_filename.js') | raw }}
{{ webpackAssets.tag('webpack-dev-server.js') | raw }}
```

Keep in mind that there’s a performance trade-off to preloading too many font assets, so limit your use to only the highest-priority font assets. For the same reason, the plugin will only create tags for the WOFF2 font format. (See [“The Critical Request”](https://calibreapp.com/blog/critical-request/) and [“The Web Fonts: Preloaded”](https://www.zachleat.com/web/preload/) for more information.)

### Component options

[](#component-options)

`publicFolder` (default: "www")

If you are [using a public folder in OctoberCMS](https://octobercms.com/docs/setup/configuration#public-folder) (you should be!), specify it here. E.g. "www" or "public"

```
[webpackAssets]
publicFolder = public

```

`assetsFolder` (default: "assets")

The path to the folder, relative to your public folder, to which webpack is writing your assets. This corresponds to `output.path` from your webpack config.

```
[webpackAssets]
assetsFolder = assets

```

`manifestFilename` (default: "manifest.json", must be relative to assetsFolder)

```
[webpackAssets]
manifestFilename = files.json

```

Changelog
---------

[](#changelog)

### 2.0.3

[](#203)

- October 1.1 compatible

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance59

Moderate activity, may be stable

Popularity26

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~240 days

Recently: every ~474 days

Total

10

Last Release

1216d ago

Major Versions

1.0.6 → 2.0.02018-05-10

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/334526?v=4)[Gabe Blair](/maintainers/gblair)[@gblair](https://github.com/gblair)

---

Top Contributors

[![lthurston](https://avatars.githubusercontent.com/u/202726?v=4)](https://github.com/lthurston "lthurston (3 commits)")[![kylepratuch](https://avatars.githubusercontent.com/u/13619388?v=4)](https://github.com/kylepratuch "kylepratuch (2 commits)")[![dananjohnson](https://avatars.githubusercontent.com/u/12454203?v=4)](https://github.com/dananjohnson "dananjohnson (1 commits)")

---

Tags

octobercmswebpackoctoberoctobercmswebpack

### Embed Badge

![Health badge](/badges/castiron-webpackassets-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/castiron-webpackassets-plugin/health.svg)](https://phpackages.com/packages/castiron-webpackassets-plugin)
```

###  Alternatives

[rainlab/builder-plugin

Builder plugin for October CMS

17147.8k1](/packages/rainlab-builder-plugin)[rainlab/user-plugin

User plugin for October CMS

11855.3k17](/packages/rainlab-user-plugin)[rainlab/pages-plugin

Pages plugin for October CMS

12254.6k4](/packages/rainlab-pages-plugin)[rainlab/blog-plugin

Blog plugin for October CMS

17159.8k](/packages/rainlab-blog-plugin)[rainlab/translate-plugin

Translate plugin for October CMS

12769.2k11](/packages/rainlab-translate-plugin)[rainlab/sitemap-plugin

Sitemap plugin for October CMS

2284.0k1](/packages/rainlab-sitemap-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)