Mark Jaquith

Encute provides a fluent, declarative API for site owners to manipulate the scripts and styles that WordPress, themes, and plugins shove onto their site. Move things into the footer, defer loading, remove assets entirely. Or load scripts async, or as modules, or as nomodule!
Here’s an example of how you could use the plugin:
<pre><code><?php

use CWS\Encute\{ Plugin, Script, Style };

add_action(Plugin::class, function (Plugin $plugin) {
 $isContactPage = fn () => is_page('contact');
 Script::get('contact-form-7')->keepIf($isContactPage)->footer()->defer();
 Style::get('contact-form-7')->keepIf($isContactPage)->footer()->defer();

 Style::get(['mediaelement', 'wp-mediaelement'])->footer()->defer();
 Style::get('material-icons')->defer();
 Script::get('jquery')->remove();
});
</code></pre>
<h3>Wrapper</h3>
Always run code in this wrapper:
<pre><code>add_action(\CWS\Encute\Plugin::class, function (\CWS\Encute\Plugin $encute) {
 // Your code here.
});
</code></pre>
This wrapper will be a no-op if Encute is not available, and it will both wait for Encute to be available to run, and pass you Encute’s main class instance.
<h3>Fluency</h3>
Both <code>Script::get()</code> and <code>Style::get()</code> return an instance of themselves, as do all calls to their methods, so you can just chain your calls.
<h3>Script</h3>
<ul>
<li><code>static CWS\Encute\Script::get(string $handle): CWS\Encute\Script</code> — get a Script instance for that handle.</li>
<li><code>CWS\Encute\Script::module(): CWS\Encute\Script</code> — make the script a module.</li>
<li><code>CWS\Encute\Script::noModule(): CWS\Encute\Script</code> — make the script nomodule.</li>
<li><code>CWS\Encute\Script::footer(): CWS\Encute\Script</code> — send the script to the footer (along with its entire dependency family).</li>
<li><code>CWS\Encute\Script::async(): CWS\Encute\Script</code> — make the script async.</li>
<li><code>CWS\Encute\Script::defer(): CWS\Encute\Script</code> — make the script defer.</li>
<li><code>CWS\Encute\Script::remove(): CWS\Encute\Script</code> — remove the script.</li>
<li><code>CWS\Encute\Script::removeIf(callable $callback): CWS\Encute\Script</code> — remove the script if the callback resolves as true.</li>
<li><code>CWS\Encute\Script::keepIf(callable $callback): CWS\Encute\Script</code> — keep the script if the callback resolves as true (else remove it).</li>
</ul>
<h3>Style</h3>
<ul>
<li><code>static CWS\Encute\Style::get(string $handle): CWS\Encute\Style</code> — get a Style instance for that handle.</li>
<li><code>CWS\Encute\Style::footer(): CWS\Encute\Style</code> — send the style to the footer (along with its entire dependency family).</li>
<li><code>CWS\Encute\Style::defer(): CWS\Encute\Style</code> — defer the style’s loading.</li>
<li><code>CWS\Encute\Style::remove(): CWS\Encute\Style</code> — remove the style.</li>
<li><code>CWS\Encute\Style::removeIf(callable $callback): CWS\Encute\Style</code> — remove the style if the callback resolves as true.</li>
<li><code>CWS\Encute\Style::keepIf(callable $callback): CWS\Encute\Style</code> — keep the style if the callback resolves as true (else remove it).</li>
</ul>

Encute

Fluent API for site owners to manipulate the scripts and styles on the frontend of their site.

Amr Abdelkarem

AssetPilot helps you speed up WordPress by controlling which scripts and styles load on which pages — without guessing handle names in <code>functions.php</code>.
Scan a real page URL, see every enqueued asset (and many from the HTML), then create rules to disable, defer, async, preload, or set fetch priority — only where your conditions match (homepage, shop, mobile, logged-in users, specific URLs, and more).
Built for site owners who want measurable wins and for developers who want conditional dequeue with guardrails: validation warnings, dependency insight, scan history, and Safe Mode if something breaks.
<h4>Why AssetPilot instead of a simple “unload” plugin?</h4>
<ul>
<li>See before you change — scan a URL and browse assets with origin, size, and usage hints.</li>
<li>Rules, not one-off hacks — reusable conditions (page type, archive, WooCommerce views, device, auth, URL).</li>
<li>Bulk actions — one rule for many handles (e.g. a plugin’s scripts everywhere except checkout).</li>
<li>Safer changes — conflict checks, impact preview, optional verification, automatic runtime pause after repeated errors.</li>
<li>Stay in control — dependency graph, recommendations, debug logs, and Safe Mode.</li>
</ul>
<h4>What you can do</h4>
<ul>
<li>Disable scripts and styles you do not need on specific views</li>
<li>Defer or async JavaScript to reduce render-blocking work</li>
<li>Preload critical scripts, styles, fonts, and images</li>
<li>Set <code>fetchpriority</code> on images and preloads</li>
<li>Target by singular page, post type, archive, URL fragment, query string, device, login state, user role, WooCommerce page type, and scan URL</li>
<li>Create bulk rules from the asset list</li>
<li>Review optimization recommendations from scan data</li>
<li>Explore asset dependencies in a visual graph</li>
<li>Keep scan history and compare what changed over time</li>
</ul>
<h4>Typical use cases</h4>
<ul>
<li>Stop a plugin’s CSS/JS on pages where it is not used (blog posts, landing pages, archives)</li>
<li>Defer non-critical scripts on catalog pages while keeping checkout intact</li>
<li>Preload hero fonts or LCP images on key templates only</li>
<li>Audit what Elementor, WooCommerce, or form plugins actually enqueue before tightening rules</li>
</ul>
<h4>How it works</h4>
<ol>
<li>Open AssetPilot → Assets and scan a page (your homepage, a product page, a form page, etc.).</li>
<li>Pick an asset (or select several for a bulk rule).</li>
<li>Choose an action and conditions (where the rule applies).</li>
<li>Review validation and impact, then save.</li>
<li>Visit the front end — use Safe Mode anytime you need to disable all runtime rules instantly.</li>
</ol>
The block editor includes an AssetPilot sidebar on supported setups so you can jump from a post to asset management with context.
<h4>Requirements</h4>
<ul>
<li>WordPress 6.2+</li>
<li>PHP 8.1+</li>
<li>Administrator access to configure rules</li>
</ul>
Frontend runtime changes apply to public site views, not the WordPress admin dashboard.
<h3>Getting started</h3>
First rule in a few minutes
<ol>
<li>Assets → enter your site homepage URL → scan.</li>
<li>Find a script or style from a plugin you suspect is unnecessary on the homepage.</li>
<li>Click to create a rule → choose Disable (or Defer for scripts).</li>
<li>Set a condition such as “this scan URL only” or “non-WooCommerce pages” if you are testing carefully.</li>
<li>Save, open the homepage in a private window, and confirm the site still works.</li>
</ol>
Use Recommendations after a few scans for ideas (duplicate libraries, large files, low usage patterns).
Create Rule is opened from assets or recommendations — it is the guided wizard for actions, conditions, validation, and review.
<h3>Safe Mode</h3>
If the site looks wrong after applying rules, enable Safe Mode while logged in as an administrator:
<pre><code>/wp-admin/?assetpilot-safe-mode=1
</code></pre>
Safe Mode turns off all frontend runtime rule changes for the whole site. The admin UI, REST API, scanning, and rule editing still work. Clear any page cache after enabling if changes seem to stick.
If repeated frontend fatals occur, AssetPilot pauses runtime rules for 30 minutes automatically. Resume early from Settings or:
<pre><code>/wp-admin/admin.php?page=assetpilot-settings&assetpilot-resume-runtime=1<h3>Development</h3>
</code></pre>
Source repository: https://github.com/amrelarabi/assetpilot
Human-readable UI source is in <code>assets/src/</code>. Production bundles in <code>assets/build/</code> are built with <a href="https://www.npmjs.com/package/@wordpress/scripts" rel="nofollow ugc">@wordpress/scripts</a>.
Build (contributors only):
<ol>
<li><code>npm install</code></li>
<li><code>npm run build</code></li>
</ol>
PHP lives under <code>includes/</code> (Composer PSR-4, <code>AssetControl\</code> namespace).
Third-party frontend libraries: <code>@xyflow/react</code> (dependency graph), <code>react-select</code> (rule builder fields).
Extension hooks: <code>assetpilot_rest_register</code>, <code>assetpilot_admin_localize</code>, <code>assetpilot_admin_menu_pages</code>, <code>assetpilot_scan_saved</code>, <code>assetpilot_condition_handlers</code>, <code>assetpilot_site_key_scan_urls</code>, <code>assetpilot_site_key_scan_max_urls</code>, <code>assetpilot_key_pages_scan_complete</code>

AssetPilot – Granular control over frontend assets

Conditionally disable, defer, and preload scripts and styles — with page scans, safety checks, and Safe Mode.

Encute vs AssetPilot – Granular control over frontend assets