sitespeed.io/README.md

sitespeed.io

Website | Documentation | Changelog | Mastodon

Table of Contents

• Welcome to the Wonderful World of Web Performance
  • What is sitespeed.io?
  • Why Choose sitespeed.io?
  • Dive Into Our Documentation
• Introduction
• Installation
  • Docker
  • NodeJS
• Usage
  • Examples
• Contributing
• Reporting Issues
• Community and Support
• License

Welcome to the wonderful world of web performance!

Welcome to sitespeed.io, the comprehensive web performance tool designed for everyone passionate about web speed. Whether you're a developer, a site owner, or just someone curious about website performance, sitespeed.io offers a powerful yet user-friendly way to analyze and optimize your website.

What is sitespeed.io?

sitespeed.io is more than just a tool; it's a complete solution for measuring, monitoring, and improving your website's performance. Built with simplicity and efficiency in mind, it enables you to:

• Test Websites Using Real Browsers: Simulate real user interactions and conditions to get accurate performance data.
• Speed Optimization Feedback: Get detailed insights into your website's construction and discover opportunities for enhancing speed.
• Track Performance Over Time: Monitor changes and trends in your website's performance to stay ahead of potential issues.

Why Choose sitespeed.io?

• Open Source and Community-Driven: Built and maintained by a community, ensuring continuous improvement and innovation.
• Versatile and Extensible: Whether you're running a simple blog or a complex e-commerce site, sitespeed.io adapts to your needs.
• Seamless Integration: Easily incorporate sitespeed.io into your development workflow, continuous integration systems, and monitoring setups.

Dive Into Our Documentation

We've put countless hours into our documentation to help you get the most out of sitespeed.io. From installation guides to advanced usage scenarios, our documentation is a treasure trove of information and tips.

Introduction

Sitespeed.io is a complete web performance tool that helps you measure the performance of your website. It is designed to:

1. Test websites using real browsers, simulating real user connectivity.
2. Analyze your page’s construction and provide feedback for speed optimization.
3. Collect and maintain data on page construction for easy tracking of changes.

Use cases on when to use sitespeed.io. Web performance audit: Run performance tests from your terminal. Continuous Integration: Detect web performance regressions early in the development cycle. Production Monitoring: Monitor performance in production and get alerted on regressions.

Installation

Docker

docker run --rm -v "$(pwd)":/sitespeed.io sitespeedio/sitespeed.io https://www.sitespeed.io/

NodeJS

npm i -g sitespeed.io
sitespeed.io https://www.example.com

Using NodeJS requires additional software like FFmpeg and Python dependencies if you want all functionality. You can read how to install that here.

Usage

sitespeed.io is designed to be straightforward to use, regardless of your experience level. Here's a quick guide on how to get started.

sitespeed.io https://www.example.com --browser chrome -n 5

That will test https://www.example.com using Chrome with 5 iterations.

You can checkout all configuration options here or run sitespeed.io --help to see all the options.

Examples

sitespeed.io generates HTML reports.

Here's an example of a summary report in HTML:

And an individual page report:

sitespeed.io makes it easy to monitor your websites performance over time. We have an example setup up and running at dashboard.sitespeed.io using sitespeed.io, Graphite and Grafana.

Collected metrics from a URL in Graphite/Grafana:

And look at trends in Grafana:

Video - easiest using Docker. This gif is optimized, the quality is much better IRL:

s

Contributing

We welcome contributions from the community! Whether you're fixing a bug, adding a feature, or improving documentation, your help is valuable. Here’s how you can contribute:

1. Create an Issue: Create an issue and discuss with us how to implement the issue.
2. Fork and Clone: Fork the repository and clone it locally.
3. Create a Branch: Create a new branch for your feature or bug fix.
4. Develop: Make your changes. Ensure you adhere to the coding standards and write tests if applicable.
5. Test: Run tests to ensure everything works as expected.
6. Submit a Pull Request: Push your changes to your fork and submit a pull request to the main repository.

Before contributing, please read our CONTRIBUTING.md for more detailed information on how to contribute.

Reporting Issues

Found a bug or have a feature request? Please use the GitHub Issues to report them. Be sure to check existing issues to avoid duplicates.

Community and Support

Join our community! Whether you need help, want to share your experience, or discuss potential improvements, there are several ways to get involved:

• Slack: Connect with fellow users and the development team on Slack.
• GitHub Issues: For technical questions, feature requests, and bug reports, use our GitHub issues.
• RSS/Changelog: Latest releases and information can always be found in our RSS feed and in our changelog.
• Mastodon: Follow us on Mastodon https://fosstodon.org/@sitespeedio.

We're excited to have you in our community and look forward to your contributions and interactions!

License

The MIT License (MIT).