lighthouse-cli

# Lighthouse CLI Guide

Lighthouse is an open-source automated tool for improving web page quality. This guide provides essential workflows and quick references for auditing web performance, accessibility, SEO, and best practices.

## Quick Start

```bash
# Check Lighthouse installation
lighthouse --version

# Run your first audit
lighthouse https://example.com

# Audit localhost
lighthouse http://localhost:3000

# Generate JSON report
lighthouse https://example.com --output=json

# View help
lighthouse --help
```

## Common Workflows

### Workflow 1: Complete Performance Audit

```bash
# Audit with both HTML and JSON reports
lighthouse https://example.com --output=html --output=json

# View performance scores
lighthouse https://example.com --output=json | jq '.categories'

# Check specific category score
lighthouse https://example.com --output=json | jq '.categories.performance.score'
```

### Workflow 2: Mobile vs Desktop Testing

```bash
# Mobile performance audit
lighthouse https://example.com --preset=mobile --output=html

# Desktop performance audit
lighthouse https://example.com --preset=desktop --output=html

# Both reports
lighthouse https://example.com --preset=mobile --output=json --output-path=./reports/mobile.json
lighthouse https://example.com --preset=desktop --output=json --output-path=./reports/desktop.json
```

### Workflow 3: Selective Category Auditing

```bash
# Audit accessibility only
lighthouse https://example.com --only-categories=accessibility

# Audit performance and SEO only
lighthouse https://example.com --only-categories=performance,seo

# All categories except PWA
lighthouse https://example.com --skip-categories=pwa
```

### Workflow 4: Batch Auditing Multiple URLs

```bash
# Create reports directory
mkdir -p reports

# Audit multiple URLs
lighthouse https://example.com --output=html --output-path=./reports/example-com.html
lighthouse https://example.org --output=html --output-path=./reports/example-org.html

# Or with loop
for url in