perf-budget-cli

Web performance budget checker — test TTFB, response time, and page size against configurable limits. Zero dependencies.

Install

npm install -g perf-budget-cli
# or use directly
npx perf-budget-cli https://example.com

Usage

# Check performance against default budgets
perf-budget-cli https://example.com

# Set custom TTFB limit (ms)
perf-budget-cli https://example.com --ttfb 200

# Set response time limit
perf-budget-cli https://example.com --response-time 1000

# Check multiple URLs
perf-budget-cli https://example.com https://example.com/about

# Output results as JSON
perf-budget-cli https://example.com --json

# Use a budget config file
perf-budget-cli --config budget.json

Features

• Measures TTFB, total response time, and page payload size
• Configurable budget limits per metric
• CI-friendly exit codes (non-zero on budget breach)
• Supports multiple URL checks in one run
• Outputs pass/fail table or JSON
• Zero external dependencies