PHPackages                             hungrysandwichclub/thunderblight - 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. hungrysandwichclub/thunderblight

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

hungrysandwichclub/thunderblight
================================

Debundle your Vite manifests quickly

1.0.1(5y ago)417MITPHP

Since Mar 9Pushed 5y ago2 watchersCompare

[ Source](https://github.com/hungrysandwichclub/Thunderblight)[ Packagist](https://packagist.org/packages/hungrysandwichclub/thunderblight)[ RSS](/packages/hungrysandwichclub-thunderblight/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

Thunderblight
=============

[](#thunderblight)

[![Craft CMS](https://camo.githubusercontent.com/c5a226714f6076de06fdf5477ddec6d23f905f0590e87db0b52290afe3f382f7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4372616674253230434d532d332e782d726564)](https://craftcms.com)

[![Usain Bolt](bolt.gif)](bolt.gif)

**Tunderblight is a Craft CMS plugin which makes using Vite ⚡️ manifest files easy.**

Extends twig to decode the manifest.json format produced by Vite on build.

Requirements
------------

[](#requirements)

This module requires Craft CMS 3.0.0-RC1 or later.

Installation
------------

[](#installation)

Install the plugin using composer in your Craft project:

```
composer require hungrysandwichclub/thunderblight

```

Usage
-----

[](#usage)

Once installed activated in Craft (Settings → Plugins) you can then use Thunderblight in your twig files as a filter:

```
{% set manifest = 'path/to/manifest.json' %}
{% set vite = manifest | thunderblight %}

```

This will look for a manifest file created by Vite, you must specify this in your Vite config by setting the `build.output` path. You will need to also enable the `build.manifest` option by setting it to true. For more information please check the [Vite Config Documention.](https://vitejs.dev/config/#build-options)

With this object you can then output your static files and assets like so:

```
{% for css in vite.css %}

{% endfor %}

{% for js in vite.js %}

{% endfor %}

```

This will support chunking of files.

We recommend using Craft's Environment variable found in your .env file to make appropriate checks to serve correct files. More information can be found in the [Craft Documentation](https://craftcms.com/docs/3.x/config/#environmental-configuration) about configuring your project.

```
{% set env = getenv('ENVIRONMENT') %}

```

### Vite Config

[](#vite-config)

With this setup your project will now work with your build files after running `npm run build` in your vite src folder. But how about local development? I hear you ask.

If you're running your Craft installation locally we recommend running the Vite dev server on a different port to your current project, then we can treat the dev server as an external host for our files and retrieve them like we would from a CDN. For more information on setting this up please check Vite's [Backend Intergration Guide.](https://vitejs.dev/guide/backend-integration.html).

With the above teachings applied we'd include our files like so:

```

```

We've included an example `vite.config.js` file in the `example` folder in this repo to get you up and running quickly.

With all these steps in place we have the following code:

```
{% set env = getenv('ENVIRONMENT') %}

{% if env == 'dev' %}

{% else %}

    {% set manifest = '{{ siteurl }}/dist/manifest.json' %}
    {% set vite = manifest | vitedebundle %}

    {% for css in vite.css %}

    {% endfor %}

    {% for js in vite.js %}

    {% endfor %}

{% endif %}

```

We've left this open to your interpretation should you prefer to load your assets using a different strategy, we'd love to hear your thoughts on how this could be improved!

Thunderblight roadmap
---------------------

[](#thunderblight-roadmap)

Some things to do, and ideas for potential features:

- Plugin settings panel - set path to build and server host IP/port
- Handling multiple Vite pages in the Manifest
- Static Assets handling

Useful Links and Credits
------------------------

[](#useful-links-and-credits)

-
-
-

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

2

Last Release

1890d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/11662791?v=4)[Joe Quigley-Jones](/maintainers/joeqj)[@joeqj](https://github.com/joeqj)

---

Top Contributors

[![joeqj](https://avatars.githubusercontent.com/u/11662791?v=4)](https://github.com/joeqj "joeqj (18 commits)")

---

Tags

craft-plugincraftcmsvitecmsCraftcraftcmscraft-pluginthunderblight

### Embed Badge

![Health badge](/badges/hungrysandwichclub-thunderblight/health.svg)

```
[![Health](https://phpackages.com/badges/hungrysandwichclub-thunderblight/health.svg)](https://phpackages.com/packages/hungrysandwichclub-thunderblight)
```

###  Alternatives

[verbb/navigation

Create navigation menus for your site.

90683.7k17](/packages/verbb-navigation)[verbb/formie

The most user-friendly forms plugin for Craft.

101372.9k40](/packages/verbb-formie)[verbb/comments

Add comments to your site.

13753.1k](/packages/verbb-comments)[verbb/tablemaker

Create customizable and user-defined table fields.

40168.8k1](/packages/verbb-tablemaker)[supercool/tablemaker

Create customizable and user-defined table fields.

40141.7k](/packages/supercool-tablemaker)[pennebaker/craft-architect

CraftCMS plugin to generate content models from JSON/YAML data.

72148.5k5](/packages/pennebaker-craft-architect)

PHPackages © 2026

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