@luis-neira/perfdash
v1.1.0
Published
CLI to measure startup & page performance for a service started by a command
Readme
PerfDash
PerfDash is a CLI tool to monitor the startup performance of any command (e.g., a local dev server). It runs your command concurrently while:
- Polling a specified URL for server readiness.
- Measuring page load metrics with Puppeteer.
- Displaying results in a clean, tabular format.
Features
- Run any command (
--cmd) concurrently with performance measurements. - Poll server readiness (HTTP status) with automatic retries.
- Measure page load metrics using Puppeteer:
- DOMContentLoaded
- Full page load (
window.load)
- Verbose logging option for detailed output.
- Results are displayed in a formatted table.
- Built with ESM Node.js and modern async/await patterns.
Installation
npm install -g @luis-neira/perfdashNotes
- The tool prefixes logs from your command (--cmd) so you can distinguish them from PerfDash logs.
- Server readiness polling uses undici.
- Page load metrics are collected using Puppeteer.
- Supports verbose mode for detailed attempt logs and page load events.
- The CLI ensures that the child process is terminated if PerfDash exits.
