No description
Find a file
Danilo Carbonaro 42711456e2 Tidy the i18n layer after review
- Badges that react to sharks, anchors, crocodiles and llamas read the
  English text of the incident again, so they unlock in every language.
- Scenario names are looked up when shown, so they follow a language switch.
- Fall back to English (and lang="en") when the dictionary did not load,
  and version the dictionary URL so a release never pairs with a stale one.
- Share the segmented-button helper between settings and the title screen,
  merge keys that only differed in a placeholder name, and slim the check
  script.
- Tests: guard the hooks the tour patches into fireFailure/fireEvent, and
  cover the dictionary fallback and the scenario name.
2026-10-24 21:52:27 +02:00
.github/workflows Fix map wrap, touch and keyboard input; harden build and release workflow; docs 2026-10-23 17:56:34 +02:00
scripts Tidy the i18n layer after review 2026-10-24 21:52:27 +02:00
site Tidy the i18n layer after review 2026-10-24 21:52:27 +02:00
tests Tidy the i18n layer after review 2026-10-24 21:52:27 +02:00
.gitignore Series of Tubes 1.0.0 2026-10-23 09:01:39 +02:00
CHANGELOG.md Add Italian translation and a language switch 2026-10-24 21:52:27 +02:00
package-lock.json Release 1.11.0 2026-10-24 21:51:33 +02:00
package.json Add Italian translation and a language switch 2026-10-24 21:52:27 +02:00
README.md Add Italian translation and a language switch 2026-10-24 21:52:27 +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 subsea cable systems modelled on real ones, 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.

The game speaks English and Italian. It follows your browser's language the first time and remembers the one you pick under Settings or on the title screen.

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
npm run i18n:check  # lists text missing from (or stale in) the translations
site/                  everything that is deployed
  index.html           the whole game (HTML, CSS and JS in one file)
  i18n/it.js           Italian translation, loaded only when the game runs in Italian
  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 (pushes to main and PRs) and release.yml (Pages deploy)

Translations

English is the source text. Player-facing strings in index.html go through tr('Unlocks at level {n}.', {n}) (or trn(one, other, n) for plurals); static markup uses data-i18n, and aria-label/title are translated at boot. Each language is a site/i18n/<lang>.js file mapping the English text to its translation, plus an entry in SOT_LANGS (the language loader at the top of the page). Missing entries fall back to English, so new English text never breaks the game; npm run i18n:check lists what needs translating, and the tests make sure every translation keeps its {placeholders} and HTML tags.

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. It refuses to build when the CHANGELOG has no ## [<version>] section (rename [Unreleased] first). Pre-releases never deploy, also not when run by hand, and a version older than the live one is refused unless you tick allow_older (a deliberate rollback). 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. Releases deploy from tags, so in Settings → Environments → github-pages → Deployment branches and tags, add a tag rule for v* (by default only the default branch may deploy). 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"]