Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cleverage/daltons
a command-line tool that computes optimal image widths to put in srcset attributes of responsive images
https://github.com/cleverage/daltons
image images performance responsive-design responsive-images responsive-web-design webperf
Last synced: 3 months ago
JSON representation
a command-line tool that computes optimal image widths to put in srcset attributes of responsive images
- Host: GitHub
- URL: https://github.com/cleverage/daltons
- Owner: cleverage
- License: mit
- Created: 2018-08-23T10:05:47.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-06-19T01:39:14.000Z (8 months ago)
- Last Synced: 2024-06-19T08:38:22.410Z (8 months ago)
- Topics: image, images, performance, responsive-design, responsive-images, responsive-web-design, webperf
- Language: JavaScript
- Homepage: https://cleverage.github.io/daltons/
- Size: 2.17 MB
- Stars: 39
- Watchers: 5
- Forks: 5
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Daltons
[](https://travis-ci.org/cleverage/daltons)
[](https://snyk.io/test/github/cleverage/daltons?targetFile=package.json)
[](https://github.com/cleverage/daltons/blob/master/LICENSE.md)
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fcleverage%2Fdaltons?ref=badge_shield)
[](https://github.com/cleverage/daltons/stargazers)
`daltons` is a command-line tool that computes optimal image widths to put in [`srcset`](https://html.spec.whatwg.org/multipage/embedded-content.html#attr-img-srcset) attributes of [responsive images](https://responsiveimages.org/).
## Why do we need this tool?
We want to provide the best experience to [our clients](https://www.clever-age.com/en/our-work/)’ users, so optimizing web performance is one of our main concerns.
Using responsive images in every projects, we wanted to be able to make it as efficient as possible. The main difficulty is choosing the image widths we put in `srcset` attributes, because nothing in the standard tells us about this.
## How does it work?
It takes 3 steps for `daltons` to find the best widths to put in the `srcset` attribute of a responsive image:
- take Real User Monitoring (RUM) of viewport widths and screen densities
- list the image’s widths across all of these viewport widths
- compute the optimal image widths to put in the `srcset` attribute to cover all these needs
Learn more in [the full documentation](https://cleverage.github.io/daltons/).
## Usage
To install and run this application, you’ll need [Node.js](https://nodejs.org/en/download/) (which comes with [npm](http://npmjs.com)) installed on your computer.
From your command line, install `daltons` as a global package:
```
npm i -g github:cleverage/daltons
```
Then run it with the `-h` option to get help:
```
npx daltons -h
```
Or see detailed options in [the full documentation](https://cleverage.github.io/daltons/options.html) and look at [examples and use cases](https://cleverage.github.io/daltons/#examples-and-use-cases).
## Built with
- [Node.js](https://nodejs.org/en/)
- [Puppeteer](https://developers.google.com/web/tools/puppeteer/), a Node.js library which provides a high-level API to control headless Chrome
## Authors
- [Nicolas Hoizey](https://github.com/nhoizey): Idea and initial work, maintainer
- [Yvain Liechti](https://github.com/ryuran): Early contributor, maintainer
See also the list of [contributors](https://github.com/cleverage/daltons/contributors) who participated in this project.
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fcleverage%2Fdaltons?ref=badge_large)
## Related projects
- [Sizer-Soze](https://blog.yoav.ws/who_is_sizer_soze/), developed by [Yoav Weiss](https://github.com/yoavweiss), “is a utility that enables you to evaluate how much you could save by properly resizing your images to match their display size on various viewports”.
- [imaging-heap](https://github.com/filamentgroup/imaging-heap), developed by [Zach Leatherman](https://github.com/zachleat) is “a command line tool to measure the efficiency of your responsive image markup across viewport sizes and device pixel ratios”.