No description
Find a file
2026-10-23 11:53:59 +02:00
.github/workflows Series of Tubes 1.0.0 2026-10-23 09:01:39 +02:00
scripts Persist games across reloads and announce new releases 2026-10-23 11:42:28 +02:00
site Add event networks, SD-WAN chains, wholesale waves and dark fiber pair leases 2026-10-23 11:52:57 +02:00
tests Add event networks, SD-WAN chains, wholesale waves and dark fiber pair leases 2026-10-23 11:52:57 +02:00
.gitignore Series of Tubes 1.0.0 2026-10-23 09:01:39 +02:00
CHANGELOG.md Release 1.3.0 2026-10-23 11:53:59 +02:00
package-lock.json Release 1.2.0 2026-10-23 11:43:58 +02:00
package.json Release 1.3.0 2026-10-23 11:53:59 +02:00
README.md Persist games across reloads and announce new releases 2026-10-23 11:42:28 +02:00

Series of Tubes

Build the internet, one tube at a time. A free cartoon browser game about how the internet really works. Play it at seriesoftub.es.

Series of Tubes

You start with one router in one city and grow into a transit-free Tier 1:

  • Customers: home broadband ("eyeballs"), enterprises, hosting, L2VPNs, DDoS protection, high-frequency traders with latency budgets, AI GPU data centers and hyperscaler DCI deals. Some come with very specific requirements.
  • Interconnection: IP transit billed on the 95th percentile, internet exchanges with route servers, open/selective/restrictive/paid peering, PNIs, embedded CDN caches, and NNI fabrics for virtual circuits and remote peering.
  • Infrastructure: leased waves on around 40 real-ish subsea cable systems, dark fiber (leased or self-built) lit with DWDM and ZR+ optics, router generations that cap your port speeds, and LAGs to bundle ports when one isn't enough.
  • Traffic engineering: see exactly what fills each link, tune link metrics and egress preferences, and route traders over the fastest path and backups the scenic way.
  • Things break, constantly: backhoes, sharks, fat fingers, route leaks, RPKI mishaps, DDoS, cooling failures, Red Sea and Baltic cable cuts, sanctions and sovereign internet drills.

Every company is a pun. No real company names are used.

Playing locally

It is a single static page with no build step for development:

open site/index.html          # or: npm run serve

Progress is saved in your browser's local storage.

Development

npm ci
npm test       # headless tests: boot, geography, a year of play, every incident, every panel
npm run build  # writes the deployable site to _site/ with version and date stamped in
site/                  everything that is deployed
  index.html           the whole game (HTML, CSS and JS in one file)
  images/og-image.png  social preview (1200×630)
  favicon.*, icon-*    favicons, app icons, manifest
  robots.txt, sitemap.xml, llms.txt, 404.html, CNAME
scripts/build.sh       copies site/ to _site/ and stamps __VERSION__ / __BUILD_DATE__
tests/                 node:test + jsdom
.github/workflows/     ci.yml (every push) and release.yml (Pages deploy)

Releasing

Only published releases reach seriesoftub.es. Pushes to main run CI and nothing else.

  1. Bump version in package.json (semver) and add a CHANGELOG.md entry. Write the bullets for players: the build turns that section into the in-game "What's new" card and into /version.json, which open games poll to offer a reload.
  2. Merge to main.
  3. Publish a GitHub release tagged v<version>, e.g. gh release create v1.1.0 --generate-notes.

The release workflow checks that the tag matches package.json, runs the tests, builds, deploys to GitHub Pages and pings IndexNow. Pre-releases never deploy. To redeploy an existing release, run the workflow manually with its tag.

Hosting setup

GitHub Pages serves the site with Source: GitHub Actions and the custom domain seriesoftub.es. DNS for the apex domain:

seriesoftub.es.        A     185.199.108.153
seriesoftub.es.        A     185.199.109.153
seriesoftub.es.        A     185.199.110.153
seriesoftub.es.        A     185.199.111.153
seriesoftub.es.        AAAA  2606:50c0:8000::153
seriesoftub.es.        AAAA  2606:50c0:8001::153
seriesoftub.es.        AAAA  2606:50c0:8002::153
seriesoftub.es.        AAAA  2606:50c0:8003::153
www.seriesoftub.es.    CNAME fjaeckel.github.io.
stats.seriesoftub.es.  CNAME seocho.jc-ix.net.

Once DNS resolves, enable Enforce HTTPS in the repository's Pages settings.

Analytics

The game uses Ridiculytics: cookieless, no persistent identifiers, self-hosted at stats.seriesoftub.es. It only reports from seriesoftub.es itself; local copies, previews and forks stay silent. The script is pinned to ridiculytics@1.0.1 with an SRI hash.

Besides page views and session length, the game sends a few coarse events, all under the collector's 50-name cap: game_new, game_continue, play_1m … play_120m (active, unpaused play time), goal_<id>, level_2–level_4, game_year_2/3/5, win_tier1 and bankrupt.

The collector must allow the site, e.g. in sites.yaml:

sites:
  - domain: seriesoftub.es
    origins: ["https://seriesoftub.es", "https://www.seriesoftub.es"]