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