English stays the source text and the default. Player-facing strings go
through tr()/trn(), which look the English up in a per-language dictionary
(site/i18n/<lang>.js) and fall back to it unchanged. The dictionary is only
loaded when the game runs in that language. The language follows the
browser on the first visit and can be switched under Settings or on the
title screen; the choice is remembered.
- site/i18n/it.js: complete Italian translation (~1900 entries)
- scripts/i18n-check.js / npm run i18n:check: lists missing or stale entries
and translations that drop a {placeholder} or HTML tag
- tests/i18n.test.js: language selection, fallback, dictionary integrity,
and a tour of every screen, failure and event in English and Italian
130 lines
5.8 KiB
Markdown
130 lines
5.8 KiB
Markdown
# 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](https://seriesoftub.es)**.
|
||
|
||

|
||
|
||
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:
|
||
|
||
```sh
|
||
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
|
||
|
||
```sh
|
||
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](https://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](https://github.com/fjaeckel/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`:
|
||
|
||
```yaml
|
||
sites:
|
||
- domain: seriesoftub.es
|
||
origins: ["https://seriesoftub.es", "https://www.seriesoftub.es"]
|
||
```
|