Skip to content

A beautifully simple CLI for running Lighthouse audits on a statically generated (SSG) website.

License

Notifications You must be signed in to change notification settings

SlicedSilver/beam

Repository files navigation

Welcome to Beam 👋

A beautifully simple CLI for running Lighthouse audits on a statically generated (SSG) website.

Beam automates the process of testing a statically generated website during development by finding and testing the pages within your build directory. Beam strives to be simple-to-use with sensible defaults whilst allowing a range of useful options to customise it's behaviour to suit your needs.

Features:

  • Interactive terminal GUI for viewing and exploring the Lighthouse audit results for each page.
  • Supports Brotli compression so you can see the actual transfer sizes.
  • Automatically crawls through your build folder to find all the pages to test.
  • Glob patterns can be specified to customise the crawling results.
  • Testing in mobile, desktop, or both Lighthouse presets.
  • Ability to set page Media features (such as prefers-color-scheme).
  • Ability to specify different Lighthouse options for each page.
  • Save detailed Lighthouse reports to a folder of your choice.

demo animation

Prerequisites

  • node ^14.13.1 || >=16.0.0

Install

npm install --location=global beam-cli

Usage

Please read the getting started guide for a more detailed guide.

Initial Setup

beam --setup

Run Beam

beam

Additional Guides

Author

👤 Mark Silverwood

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page. You can also take a look at the contributing guide.

Show your support

Give a ⭐️ if this project helped you!

📝 License

Copyright © 2022 Mark Silverwood.
This project is MIT licensed.


This README was generated with ❤️ by readme-md-generator

About

A beautifully simple CLI for running Lighthouse audits on a statically generated (SSG) website.

Resources

License

Stars

Watchers

Forks

Packages

No packages published