- Autosave every five seconds while playing, plus on pagehide and when the tab is hidden. On load, a saved game resumes immediately (same speed and camera) instead of waiting behind the title screen. - The build turns this version's CHANGELOG section into release notes: baked into the page for a one-time "What's new" card for returning players, and published as /version.json. - Open games poll /version.json every 10 minutes and when the tab comes back into view; if a newer release is out, a banner offers to save and reload. - "Start a new network" moves into the help screen, behind a confirm.
109 lines
4.4 KiB
Markdown
109 lines
4.4 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 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:
|
||
|
||
```sh
|
||
open site/index.html # or: npm run serve
|
||
```
|
||
|
||
Progress is saved in your browser's local storage.
|
||
|
||
## 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
|
||
```
|
||
|
||
```
|
||
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](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. 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](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"]
|
||
```
|