Web Asset Triage

Automated Performance Auditing & Surgical Refactoring for High-Traffic Platforms

The Problem

Standard performance tools give you a score, but they don't give you a solution. High-traffic platforms often suffer from "Plugin Bloat", unnecessary JavaScript and CSS loading on pages where they aren't needed. Manually identifying these assets across a 100-page sitemap is a multi-day task.

The Solution

Web Asset Triage is a professional-grade CLI tool that automates the discovery of unoptimized assets. It crawls sitemaps, performs headless browser audits under "Real-World" network constraints (Slow 4G), and generates actionable refactoring recommendations.

Works "Out of the Box"

You don't need to configure a database or an API key. Once installed, Web Asset Triage uses a "Zero-Config" approach. It launches its own internal browser instance, simulates a mobile user on a 4G connection, and performs a deep-tissue scan of your site's delivery pipeline immediately.

Universal Compatibility

Web Asset Triage is designed to work across the entire web ecosystem:

• WordPress Specialist: Automatically detects /plugins/ and /themes/ paths. It cross-references assets with known WordPress handles and generates ready-to-use PHP snippets (wp_dequeue_script) to kill bloat instantly.
• General Web/Non-WordPress: Even on static sites, React apps, or custom frameworks, the tool identifies heavy external CDNs, unoptimized Google Fonts, and oversized images, providing general web-standard refactoring advice (WebP conversion, script deferral, etc.).

---

Architecture

graph LR
    A[URL/Sitemap] --> B[Headless Chrome]
    B --> C[Lighthouse Engine]
    C --> D[Triage Analyzer]
    D --> E{Exporters}
    E --> F[HTML Dashboard]
    E --> G[Markdown Table]
    E --> H[JSON Data]

Loading

Getting Started

Installation

1. Clone the repo: git clone https://github.com/hawesome/web-asset-triage.git
2. Install dependencies: npm install
3. Link the CLI tool: npm link

Usage

# Audit a single page
triage --url https://example.com

# Audit an entire sitemap in all formats
triage --sitemap https://example.com/sitemap.xml --limit 20 --format all

🛠️ CLI Command Reference

Option	Shorthand	Description	Default
--url	-u	A single URL to audit.	null
--sitemap	-s	A sitemap XML URL to audit multiple pages.	null
--format	-f	Output format: json, md, html, or all.	md
--output	-o	The directory where reports will be saved.	./reports
--limit	-l	Maximum number of pages to audit from a sitemap.	10

---

Technical Decisions

• Why Node.js? Native access to the Lighthouse/Puppeteer ecosystem for precision browser control and asynchronous task handling.
• Decoupled Architecture: The Auditor (Data Collection), Analyzer (Intelligence), and Exporters (Reporting) are isolated modules, making it easy to add new audits or formats.
• Environmental Simulation: Hardcoded network throttling ensures that performance optimizations are measured against the reality of mobile users on variable connections.