plight 🎨

 ██████╗ ██╗     ██╗ ██████╗ ██╗  ██╗████████╗
 ██╔══██╗██║     ██║██╔════╝ ██║  ██║╚══██╔══╝
 ██████╔╝██║     ██║██║  ███╗███████║   ██║   
 ██╔═══╝ ██║     ██║██║   ██║██╔══██║   ██║   
 ██║     ███████╗██║╚██████╔╝██║  ██║   ██║   
 ╚═╝     ╚══════╝╚═╝ ╚═════╝ ╚═╝  ╚═╝   ╚═╝

A beautifully formatted Lighthouse CLI tool with stunning box-style terminal output. Make Google Lighthouse audits look amazing in your terminal.

---

Why plight?

• ✨ Beautiful terminal output - Box-style borders with colored scores
• 🎨 Syntax highlighting - Color-coded pass/warn/fail status
• 📊 Core Web Vitals - LCP, CLS, FCP, INP at a glance
• 📜 Audit history - Save and replay past audits
• 🚀 Zero config - Works out of the box with sensible defaults

---

Install

# Install globally
npm install -g @12britz/plight

# Or use without installing
npx @12britz/plight <url>

Requirements: Node.js 22+, Chrome or Chromium installed.

---

Quick Start

# Basic audit
plight https://example.com

# Run with desktop emulation
plight https://example.com --emulated-form-factor desktop

# Output JSON report
plight --json https://example.com

---

Features

📝 Audit Options

Flag	Description	Example
--only-categories	Run specific categories	plight --only-categories performance,seo <url>
--emulated-form-factor	Device emulation	plight --emulated-form-factor desktop <url>
--throttling	Disable throttling	plight --no-throttling <url>
-q, --quiet	Suppress progress	plight -q <url>

📊 Output Options

Flag	Description	Example
-j, --json	Output raw JSON	plight -j <url>
-o, --output	Save to file	plight -o report.json <url>

📚 History

Flag	Description	Example
-H, --history	View all history	plight --history
-H, --history #	See entry #N	plight --history 1
-r, --replay	Replay last	plight --replay
-r, --replay #	Replay #N	plight --replay 2

---

Examples

Basic Audit

plight https://makro.co.za

Desktop Audit

plight https://example.com --emulated-form-factor desktop

Performance Only

plight --only-categories performance https://example.com

Save JSON Report

plight -j https://example.com > report.json

View History

# List all audits
plight --history

# Replay last audit
plight --replay

---

Output Example

┌──────────────────────────────────────────────────────────────┐
│         ██████╗ ██╗     ██╗ ██████╗ ██╗  ██╗████████╗        │
│         ██╔══██╗██║     ██║██╔════╝ ██║  ██║╚══██╔══╝        │
│         ██████╔╝██║     ██║██║  ███╗███████║   ██║           │
│         ██╔═══╝ ██║     ██║██║   ██║██╔══██║   ██║           │
│         ██║     ███████╗██║╚██████╔╝██║  ██║   ██║           │
│         ╚═╝     ╚══════╝╚═╝ ╚═════╝ ╚═╝  ╚═╝   ╚═╝           │
│                                                              │
│          plight  pretty Lighthouse CLI                       │
└──────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────┐
│ Category Scores                     │
├──────────────────┬────────┬─────────┤
│ Category         │ Score  │ Status  │
├──────────────────┼────────┼─────────┤
│ Performance      │ 95     │ PASS    │
│ Accessibility    │ 100    │ PASS    │
│ Best Practices   │ 92     │ PASS    │
│ SEO              │ 100    │ PASS    │
└──────────────────────────────────────┘

---

License

MIT