You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

48 lines
2.1 KiB
Markdown

# 250kb-club
An exclusive members-only club for web pages weighing no more than 250kb.
Inspired by [Bredley Taunts 1MB.club](https://1mb.club/).
## But why?
I love the idea of a list of webpages that are still reasonably usable with a slow internet connection. But 1MB is, in my honest opinion, still way too much. Nobody wants to wait 10 seconds — on good days — to load a web site. But a very large chunk of the world population isn't gifted with Gigabit internet connections.
Of course, the absolute size of a website is not a perfect indicator. A page might contain a lot of text or images as important part of their content. It would be unfair to call them bloated in this case. This is why, additionally to the absolute size the ratio of visible to invisible content is shown as well.
## Adding a web page
Please send a patch or pull request. If unsure, you can also write a ticket mentioning the website(s). The website(s) will be added after passing the review and measured for changes about once every week.
## What are those values?
The values shown in the list are URL, Total Weight, Content Ratio.
Websites listed here are downloaded and analyzed with
[Phantomas](https://github.com/macbre/phantomas).
The total weight is counted and then the size of actual content is measured
and shown as a ratio.
For example: If a website has a total weight of 100kb and 60kb are the
documents structure, text, images, videos and so on, then the content ratio
is 60%. The rest are extras like CSS, JavaScript and so on. It is hard to
say what a good ratio is but my gut feeling is that everything above 20% is
pretty good already.
## Hacking this page
This page is built with [Svelte](https://svelte.dev). You can clone the repository and run the application in development mode like this:
```sh
git clone https://git.sr.ht/~koehr/the-250kb-club 250kb-club
# or: git clone https://github.com/nkoehring/250kb-club.git
cd 250kb-club
yarn
yarn dev
```
And build the page with `yarn build`.
The website analysis is done by `compile-list.js` which reads `pages.txt` and
writes the results to `src/components/pages.mjs`. `pages.txt` is curated by hand.