v0.4.0 — build health + Lighthouse audit + shareable reports →

Your Pterodactyl build
in under 90 seconds.

One command analyzes your webpack config, finds what's slow, runs a full Lighthouse audit, and generates a shareable report — then fixes everything with a diff preview and automatic backup.

$ npx pterospeed@latest full

no install required · Node 20+ · works on any Pterodactyl fork

5 min → 78s

production build

5–10×

faster warm builds

0

code changes needed

30s

setup time

The problem

5 minutes every build.
Every. Single. Time.

The default webpack config that ships with Pterodactyl Panel was written to work, not to be fast. Every build starts from zero and pays the full cost.

Memory-only webpack cache — lost after every process
Babel re-transpiles unchanged files on every run
TerserPlugin minifying even in development builds
source-map-loader scanning all of node_modules

$ yarn build:production

webpack compiled in

352s

after pterospeed optimize --preset aggressive

~78s

same output · no code changes

4.5× faster

How it works

One command. Full picture.

pterospeed full runs build analysis and Lighthouse in one flow, then generates a shareable report link.

analyze + audit in one run

pterospeed full
$ npx pterospeed@latest full
 
✔ Detected: Pterodactyl Panel
✔ Root: /var/www/pterodactyl
✔ Source files: 312
✔ Build config scanned — 20/100
✔ Panel URL: https://panel.example.com
⠙ Running Lighthouse audit — 34s elapsed…
✔ Audit complete (1m 12s)
✔ Shareable link ready: pterospeed.me/r/x7k2mq

apply optimizations

pterospeed optimize
$ pterospeed optimize --preset aggressive --auto
 
✔ Applied 5 optimization(s).
- Filesystem cache (webpack 5)
- babel-loader disk cache
- source-map-loader scoped
- EsbuildPlugin (prod minifier)
- minimize: isProduction
 
› Production minify: ~3-4× faster
› Warm dev builds: ~5-10× faster
› Dev skips minification (~30-60s saved)

Features

Built to be trusted.

Build health scoring

0–100 score with per-finding detail, impact rating, and estimated time savings before you touch anything.

🔍

Lighthouse site audit (Experimental)

Run real Lighthouse against your live panel. Core Web Vitals, performance score, and actionable issues.

🛡

AST-safe patches

Config edits use recast — preserves your formatting. No regex, no fragile string replace.

🔗

Shareable reports

Every `full` run generates a short URL at pterospeed.me/r. Share with your team in one line.

💾

Automatic backups

Snapshot saved to .pterospeed/backups before every write. `pterospeed revert` to undo instantly.

📦

Zero config

Auto-detects Pterodactyl, webpack version, package manager, and panel URL from .env.

Optimizations

What gets fixed

Optimization Preset Expected gain
Webpack filesystem cache safe Warm builds 5–10× faster
babel-loader disk cache safe Cold builds ~20–30% faster
Scope source-map-loader safe Skips all of node_modules
Explicit CPU parallelism safe Full core utilization
minimize: isProduction safe Dev skips minification
EsbuildPlugin (prod) aggressive Production minify 3–4× faster

After aggressive preset, run yarn install to install esbuild-loader.

CLI Reference

All commands

pterospeed full [path] Build analysis + Lighthouse site audit in one run
pterospeed analyze [path] Scan webpack config and report build health score
pterospeed optimize [path] Diff → confirm → apply fixes with backup
pterospeed optimize --auto Skip confirmation prompt
pterospeed optimize --dry Show diff only, write nothing
pterospeed optimize --preset aggressive Also replace TerserPlugin → EsbuildPlugin
pterospeed audit [url] Run Lighthouse against your live panel
pterospeed benchmark [path] Measure cold / warm / production build times
pterospeed revert [path] Restore last backup

Stop waiting for builds.

No install. No config. No risk. Backup created before touching anything.

$ npx pterospeed@latest full
⭐ Star on GitHub · 📦 View on npm