- JavaScript 54%
- HTML 33%
- CSS 10%
- Python 2%
- Shell <1%
thebenmeadows.com #
Source for thebenmeadows.com — a personal link hub pointing to Ben Meadows' sites, projects, and social profiles.
It is a small static site: hand-written HTML styled with Tailwind, plus
supporting pages — /mirrors/,
/tech/, /experiments/, /infra/,
/ai/, /papers/, /art/ and /blog/. The build
compiles the CSS, the search index, the blog and the /ai/ page; there is no
framework or client-side rendering.
Search is dependency-free on purpose. The corpus is about 182 KB across 41 pages
and the index built from it about 205 KB — small enough to match in the browser
without a search library. The usual pick, Pagefind, runs on WebAssembly, which
under this site's script-src 'self' CSP would mean adding 'wasm-unsafe-eval'.
Instead scripts/build-search-index.mjs emits a JSON index at build time and
search.js matches against it in the browser; the index is fetched only when
search is first opened.
Build #
npm install
npm run build # compiles src/input.css -> output.css (minified), then builds
# search-index.json and the feeds, and refreshes the address
# tables in this file from mirrors.json
output.css and search-index.json are generated and git-ignored. Open index.html directly, or serve
the folder with any static server, after building.
Blog #
Posts are markdown in blog/posts/, one file per post, with front matter for the
title, date, tags and description. scripts/build-blog.mjs renders them into
blog/<slug>/index.html, the /blog/ index and blog/feed.xml, all git-ignored
like the CSS. It runs first in the build, because Tailwind scans the pages it
writes. It also emits blog/pages.json; build-search-index.mjs and
build-stamp.mjs read that list, so adding a markdown file is the whole of
adding a post — no other script needs editing.
Post images live in blog/media/<slug>/ as webp at 1600px — over twice the
column they display in. The originals they were made from are one to two orders
of magnitude larger and are backup material, not serving material; every image
the blog ships is under 500 KB, and the build fails if one is not. Nothing on a
post page loads from another origin, which is what lets a post survive in the
ZIM, the torrent and the Arweave copy exactly as it appears on the web.
Front matter beyond the obvious:
author:names a key inblog/authors.json, defaulting toben. That file carries akind—personoragent— and the byline,<meta name="author">and the Atom entry all follow it. An agent is named as an agent and its operator with it; aguestis marked as a guest. An unknown key fails the build, because quietly falling back to the site owner is how a guest post ends up under the wrong name.pin: 1,pin: 2promote a post to a Start here group above the dated list on/blog/. Pinned posts are not repeated below. The feed ignores pins entirely and stays in date order: an index is a page a reader chooses to open, while a feed is pushed at people who have already read what came before, and re-ordering it re-surfaces old entries as new.related:takes post slugs and site paths. Slugs link both ways — naming a post there puts this one in that post's "See also" too, so the pair cannot fall out of step. A site path such as/art/essentialism/links one way, since hand-written pages are not generated here, and its title is read from the page rather than typed twice. Anything that does not resolve fails the build.
Writing a post is: add the markdown, open a PR, merge. The mirrors pick it up on the next release.
Microformats and webmentions #
Each post page is an h-entry: the title is p-name, the date is dt-published (and dt-updated when set), the permalink is u-url, the front-matter description is p-summary, the body is e-content, and the byline is a p-author h-card built from blog/authors.json. An agent's post names the agent in that card, never Ben.
The site sends webmentions and does not receive them. scripts/send-webmentions.mjs reads the built posts, takes every outbound link in each post's e-content, discovers the target's endpoint (HTTP Link header first, then <link> or <a rel="webmention">), and posts source and target to it. It skips links to this site and its mirrors, site-relative and mailto: links, unlisted posts, and targets with no endpoint. It refuses an endpoint on a loopback or private address.
The script is not part of any build or deploy. Run it by hand after a build:
npm run build
node scripts/send-webmentions.mjs # dry run: discovers and prints, sends nothing
node scripts/send-webmentions.mjs --send # sends, and records each accepted pair
node scripts/send-webmentions.mjs --source https://thebenmeadows.com/blog/<slug>/ --send
node scripts/send-webmentions.mjs --discover <url> # print one page's endpoint, send nothing
A dry run still fetches each target page once, because discovery needs the page. Only --send posts. Each accepted (source, target) pair goes into webmentions/sent.json, and a pair in that file is never sent again. Commit the file after a --send run, so that a run on another machine skips the same pairs. A failed send is not recorded, and the next run tries it again.
Page weight #
512kb.club measures one URL — the home page — uncompressed, and its green team requires that page to stay under 100 KB. The site is on the green team, added by PR #17, and is a member of the 250kb.club. The clubs re-measure on their own schedules, so the sizes they list lag this repo. New subpages are not measured, but three home-page assets are shared with every other page and do count:
output.cssis a single Tailwind build over the@sourcelist insrc/input.css. A new page that uses utility classes not already present grows it, and the home page pays for that.theme.jsandsearch.jsare shared but fixed in size.
search-index.json grows with every page in scripts/build-search-index.mjs and with
every post under blog/posts/, but search.js fetches it on first search rather than
on load, so it stays out of the measurement. It is 205 KB — more than the entire budget on
its own, most of it blog prose — so it must stay lazy. Fetching it on load would fail
the build. It has outgrown the budget already and will keep growing with the blog, which is
survivable only because it is never part of a cold visit; the day it stops being lazy is
the day it stops being affordable.
The home page currently measures about 86 KB. scripts/build-manifest.mjs enforces the
budget on every build and fails over it, so the number cannot drift unnoticed; to check
it independently, run a
DebugBear page-weight scan.
Deploy #
- Primary: Cloudflare Pages, connected to this repo's
main. Each push runsnpm run build:netlifyand publishesdist/. - Netlify:
netlify.tomlruns the same build (npm run build:netlify, which assembles a cleandist/), for use as a second host. - Codeberg Pages and sourcehut pages: a machine of mine rebuilds from
mainhourly and pushes the built output — to apagesrepo on Codeberg, and as a tarball to pages.sr.ht. Neither host runs the build; both serve bytes that hash against the same manifest as everything else.
Releasing #
Deploying and releasing are different things here, and the mirror list below only makes sense once that split is clear.
Most surfaces are continuous: Cloudflare Pages, Netlify, the onion, the
eepsite, and the IPFS copy the IPNS name points at all rebuild themselves from
main, so a merged PR is live within a minute and nothing else has to happen.
The rest are release-pinned: the Arweave copy and the Nostr nsite hold one
specific build and only move when a release is cut. That is deliberate — those surfaces are permanent,
paid for, or signed, and none of those are things to do automatically on every
merge.
A release therefore lags main by design. scripts/build-manifest.mjs and the
proofs in commitments/ are what make the lag measurable rather than a guess.
Cutting one builds from a clean checkout of main and then, in order: uploads
to Arweave and moves the ArNS record for ar://thebenmeadows; signs the
manifest's SHA-256 to Nostr under the key this domain attests at
/.well-known/nostr.json; anchors that hash in Bitcoin with OpenTimestamps and
commits the proof to commitments/; and tags the commit YYYY.MM.DD (plus the
short SHA if a day carries more than one). The tag is annotated with the Arweave
transaction and the manifest hash, and signed when a signing key is available.
Tags replicate to every git mirror, so the record of what shipped survives the
loss of any one forge — including this one.
To check a release rather than trust it, fetch /manifest.json from any surface
and compare its hashes against the bytes that surface serves;
/mirrors/ walks through it.
Mirrors & availability #
Availability is treated as two separate concerns, each handled independently — the model borrowed from Privacy Guides:
- Serving (reachability). The same static output is published to four
independent web hosts — Cloudflare Pages (primary), Netlify,
Codeberg Pages, and sourcehut pages — and
beyond the web: a Tor onion and an I2P eepsite on self-run hardware,
IPFS from the site's own nodes (an IPNS name that ENS, Tezos, and Solana
name records all point at, and that a DNSLink record on the domain itself
also carries), a permanent Arweave copy behind
ar://thebenmeadows, a Nostr nsite, a BitTorrent download naming this origin as a webseed, a 4EVERLAND host serving each release from IPFS, and Gemini, gopher, SSH, telnet and FTP mirrors. Each release also attaches the whole site as one ZIM file, which opens offline in Kiwix. Different networks fail differently. - Resolution. DNS itself is redundant: Cloudflare and deSEC are
both authoritative for the domain, under multi-signer DNSSEC
(RFC 8901). Each provider signs
the zone with its own keys and serves both public keys, and the registry
anchors both chains, so answers validate whichever provider a resolver
asks. The zone is declared once (OpenTofu) and applied to each provider;
the hot
_dnslinkrecord is written to both on every push, and a timer alerts when the providers drift apart, including when either rotates a signing key. - Currency. Every push changes the site's IPFS hash. One machine builds, pins, publishes the IPNS name, and writes the new hash to a file it serves and to the DNSLink record; the other nodes poll that and pin what it says. None of them resolves the IPNS name itself, because IPNS records stay valid for a year and the network returns months-old ones.
- Monitoring. A mirror nobody checks is worse than no mirror: it goes stale, keeps answering, and quietly contradicts the signed manifest. So every serving surface is compared against the manifest on a schedule, the primary is re-checked hourly from two separate networks, and the machine running the automation is itself watched from another — a monitor that can fail silently is half a monitor. Staleness pages the operator before a visitor is likely to notice it.
- Source (recoverability). This repository is mirrored to Codeberg,
Gitea, GitLab, and SourceHut alongside GitHub, kept in sync
automatically. Each mirror holds the full history, so the source survives any
single forge. It is also published hostlessly twice: on Radicle as
rad:z3vBEjEJAvd3CjciS1JBiFzHda3KA, where nodes replicate it between themselves, and on Nostr via GRASP, where signed events are the authority and any compliant git server can carry it (git clone nostr://npub1wldqfuy0yge4fvxukdm43gze2ral9dnp5avlps5a6t8q0vyv2nds84nq29/tbmwith the ngit plugin), and on Tangled, where the repository lives on an AT Protocol knot and carries its own DID. Software Heritage holds a permanent archival copy. - Archive. A GitHub Action (
.github/workflows/wayback.yml) requests a Wayback Machine snapshot after every deploy, so the archived copy tracks what actually shipped. archive.today holds a second copy under a different operator, and Software Heritage archives the source. - Provenance. Every build emits
manifest.json(SHA-256 of every shipped file). Each release's manifest hash is signed to Nostr under the key this domain attests at/.well-known/nostr.jsonand anchored in Bitcoin with OpenTimestamps; the proofs live incommitments/. Any mirror can be verified against the manifest — see/mirrors/for how.
Addresses #
/mirrors/ is the canonical index, but it
is served by the site: if the domain is unreachable, so is the page listing the
alternatives to the domain. This README is mirrored to nine git hosts — five
conventional forges, Radicle, Tangled, and two Nostr GRASP servers — plus
Software Heritage, so it still resolves when nothing else does. The tables below are
generated from mirrors.json by scripts/sync-readme-mirrors.mjs — the same
file the build signs into manifest.json, so the README, the site, and the
manifest cannot disagree.
Serving — the same build, reachable by different means:
| Network | Address |
|---|---|
| Web (primary) | https://thebenmeadows.com/ |
| Web | https://netlify.thebenmeadows.com/ |
| Web | https://tbm-linktree.pages.dev/ |
| Web | https://thebenmeadows.codeberg.page/ |
| Web | https://thebenmeadows.srht.site/ |
| Tor | http://meadowsvn6ah25czpa3mv735fizgdz6xp7vlzeqxpydfwnnsygtcleyd.onion/ |
| I2P | http://d24ftl3svuczr2neg7dhlys7hgj4oinz3u3d5rwd2t4rbkbwt4wa.b32.i2p/ |
| IPFS | ipns://k51qzi5uqu5dkx54ehvkna983zjtfn04eu4sklgx2ag1tozh9js5p9cn5jwqmy |
| Arweave | ar://thebenmeadows |
| Nostr (nsite) | npub1wldqfuy0yge4fvxukdm43gze2ral9dnp5avlps5a6t8q0vyv2nds84nq29 |
| Own network (AS219158, IPv6 anycast) | https://v6.thebenmeadows.com/ |
| 4EVERLAND | https://thebenmeadows-cbvr.ipfs.4everland.app/ |
| BitTorrent | https://thebenmeadows.com/tbm.torrent |
| ZIM (offline) | https://github.com/TheBenMeadows/tbm/releases/latest |
| Gemini | gemini://gemini.thebenmeadows.com/ |
| Gopher | gopher://gopher.thebenmeadows.com/ |
| SSH | ssh://text@text.thebenmeadows.com:2222 |
| Telnet | telnet://text.thebenmeadows.com |
| Finger | finger://ben@text.thebenmeadows.com |
| Whois | whois://text.thebenmeadows.com |
| QOTD | qotd://text.thebenmeadows.com |
| FTP | ftp://text.thebenmeadows.com/ |
| rsync | rsync://text.thebenmeadows.com/tbm/ |
Source — copies whose identity is not tied to one forge:
| Network | Address |
|---|---|
| Radicle | rad:z3vBEjEJAvd3CjciS1JBiFzHda3KA |
| Tangled (ATProto) | https://tangled.org/thebenmeadows.com/tbm |
| Nostr (GRASP) | nostr://npub1wldqfuy0yge4fvxukdm43gze2ral9dnp5avlps5a6t8q0vyv2nds84nq29/tbm |
Archive — third-party copies, not under this project's control:
| Network | Address |
|---|---|
| Software Heritage | https://archive.softwareheritage.org/browse/origin/directory/?origin_url=https://github.com/TheBenMeadows/tbm |
| Wayback Machine | https://web.archive.org/web/2/https://thebenmeadows.com/ |
| archive.today | https://archive.ph/newest/https://thebenmeadows.com/ |
Git Mirrors #
The live index of every host, forge, and archive is at
/mirrors/; the stack and the design
decisions behind it are at /tech/.
Layout #
| Path | What it is |
|---|---|
index.html |
the home page (link hub) |
mirrors/, tech/ |
the mirror list and the tech-stack colophon |
profiles/ |
every profile, one page — the footer's "All" target |
experiments/, infra/ |
experiments gallery and the network/ASN colophon |
ai/wins.json |
entries for /ai/; the page is generated from it by scripts/build-ai.mjs |
papers/ |
preprints: an index plus one page per paper with Google Scholar citation_* tags; each PDF sits beside its page (the one copy on the site), byte-identical to the Zenodo file |
search/ |
the search page (/search/?q=…) |
404.html |
not-found page (self-contained, inline styles) |
src/input.css, src/tailwind.css |
Tailwind source + settings shared with the experiment stylesheets |
icons/ |
social SVGs — repo-only since the typographic redesign; the site ships no icons |
svgo.config.mjs |
optimizer settings for icons/ — run npm run optimize:icons after adding one |
favicon/, me.png |
icons and profile image |
readme-header-*.png |
the header above — keyed out of og.png by scripts/make-readme-header.py, one variant per theme; repo-only, never shipped |
theme.js |
three-state theme control (system / light / dark) |
search.js |
search overlay + /search/ page; fetches the index on first use |
scripts/build-search-index.mjs |
builds search-index.json from the pages at build time |
scripts/version-css.mjs |
content-hashes the stylesheet's dist/ filename and repoints every page at it, so a deploy can never serve new HTML with a cached old stylesheet |
scripts/build-stamp.mjs |
stamps every page with the commit it was built from |
scripts/build-feed.mjs |
emits feed.xml (Atom) + rss.xml (RSS 2.0) from the release log |
scripts/build-manifest.mjs |
emits manifest.json — SHA-256 of every shipped file |
scripts/check-figures.mjs |
asserts every KB figure in this file and /tech/ against what the tree measures; an unregistered figure fails the build |
scripts/sign-release.sh |
signs the manifest to Nostr and anchors it with OpenTimestamps |
commitments/ |
one OpenTimestamps proof per release, named for the hash it attests |
.nsite/ |
nsyte config for the Nostr nsite deploy |
_headers |
security headers + cache and CORS rules (Cloudflare/Netlify) |
.well-known/ |
identity + payment endpoints (see below) |
.well-known/ endpoints #
These serve live identity and payment lookups. Keep them in place, and served correctly, on every host that runs the site:
nostr.json— Nostr NIP-05 name verification (needsAccess-Control-Allow-Origin: *).lnurlp/ben— Lightning LNURL-pay address (needs CORS +application/json).keybase.txt— Keybase account proof.
DNS verification records (Keybase, Tezos) live at the domain and must survive any DNS change.
License #
Code is MIT. Personal images and brand assets — me.png,
btm-logo.png, and the favicon/ set — are not covered by the license;
all rights reserved. The images under experiments/intervals/ are renders of
Intervals by Jeff Davis, licensed CC BY-NC 4.0; see the NOTICE.txt there.