250kb-Club/README.md

# 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.

## 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.

## 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/pages.json`. `pages.txt` is curated by hand.