Hub (Хаб)
English · Русский
▶ Open the Hub online - the browser version (GitHub Pages);
the Windows app is in Releases.
A collection of small projects that have been fixed up, plus the Hub («Хаб»): a desktop app and a web page that open the games, programs
and system demos of this collection in tabs of one window. Until version 1.1.0 it was
called Igroteka («Игротека», "game library"); settings, records and saves stay after the
rename. The browser version is the root site https://alexalesha.github.io/.
web/ - 23 standalone HTML pages: games, tools and desktop-shell demos. Each opens
with a double click on index.html and works offline.py/ - 6 Python programs (PySide6).app/ - Hub, the Electron desktop app.
The interface of all projects is in Russian.
Hub
Twelve games in one window: Cube World, Blockcity, Operation: Perimeter, Dino Run,
Hop-Skip (a platformer), Horizon Drift, Fire Jungle, Space Shooter, Blocks, Sudoku, Flappy Wings
(«Летучая птичка», a fly-between-the-columns game) and RailRunner («Бег по рельсам»). All games are fan
concepts and are not affiliated with any rights holders.
- Programs. Below the games is a "Programs" section with seven programs: WritingSpeed
(«Скорость печати»,
web/writing-speed), a typing speed test; the Compiler («Компилятор»,
web/compiler): C, C++, Python, JavaScript, TypeScript, Lua, Ruby and SQL run right
there, offline; FilesManager («Файловый менеджер», web/files-manager) on a demo disk;
Calibrate 3D Printer («Калибровка 3D-принтера», web/calibrate3dprinter): G-code of ten
calibration tests for any FDM printer; MediaPlayer («Медиаплеер», web/media-player); two calculators,
Calc Pro Glass («Калькулятор Glass», web/calcpro-glass) and Calculator iOS 26 («Калькулятор
iOS 26», web/ios-calculator).
Each opens in a tab like a game and works offline. Of WritingSpeed only its page goes into
the app (its own Electron shell and tools stay next to it); the Compiler goes in with its
engines and the Python of web/python_ide (about 80 MB) and is not part of the one-file
Hub. Calibrate 3D Printer lives in its own repository
(site); web/calibrate3dprinter is a
copy of its web/ folder, version 1.0.0, refreshed with
node tools/sync-calibrate.js [folder] (or CALIBRATE_DIR). The calculators come from the
Calculators repository (CalculatorPro): copies of
calcpro-glass/src and ios-calculator/src, version 1.6.0,
refreshed with node tools/sync-calculators.js [folder] (or CALCULATORS_DIR); in a tab they
have no window buttons and stand in the middle. The third calculator there, Calc Pro on C# and
WPF, is not a page and is not in the Hub. No card leads out of the app.
- System demos. Below the games is a "System demos" section: shells in the style of
Windows 11, macOS, iOS and One UI (
win11_3, macos-tahoe, ios26, oneui7; not
affiliated with Apple/Microsoft/Samsung). Each opens in a tab like a game, with its own
storage; games in demo windows get the app volume and pause when the tab is left
({mix: 'pause'}).
- Tabs. Every game opens in its own tab. Clicking the card of a game that is already
open switches to its tab. Close a tab with its cross or the middle mouse button.
- Separate storage per game. One game cannot see the records and saves of another,
and everything survives a restart. The data of a single game can be cleared in the
settings without touching the others.
- Background tabs are paused and silent. A hidden game pauses, gets no animation
frames and is muted. Checked on every game.
- No network. Game pages cannot reach the internet or read files outside their own
folder. An external link opens in the system browser, and only after you confirm.
- The window remembers its size, position and maximised state, and which tabs were
open. Reopening tabs on start can be turned off in the settings.
- App-wide volume and mute, dark and light themes.
| Keys | Action |
|---|
| Ctrl+T | home screen |
| Ctrl+W | close the tab |
| Ctrl+Tab / Ctrl+Shift+Tab | next / previous tab |
| Ctrl+1 … Ctrl+9 | tab by number (Ctrl+9 is the last one) |
| F11 | game full screen without the tab bar; Esc or F11 to go back |
| F5, Ctrl+R, Ctrl+F5 | restart the game (asks first); also via the tab's right-click menu |
The keys also work with the Russian keyboard layout. Cube World keeps F1, F2, F3 and F5 for
itself (F5 switches the camera there), so in it restart with Ctrl+R, Ctrl+F5 or the tab
menu. The keys a game keeps are listed in app/games.js (the keys field).
Cube World also keeps Esc (the escToGame field): the first Esc pauses and shows the cursor, the
second resumes and hides the cursor at once, with no click. To leave the shell's fullscreen in this
game use F11 (Esc stays with the game).
In a browser the same works in the game's own fullscreen: the "Во весь экран (F)" (fullscreen)
button in the pause menu, or the F key. The game turns on keyboard lock
(navigator.keyboard.lock(['Escape']), available in Chrome and Edge), so Esc reaches the game; to
leave fullscreen hold Esc (the browser shows a hint) or press F. Browser fullscreen via F11 does
not enable keyboard lock (it is granted only to a page in fullscreen through the Fullscreen API), so
there, as in a normal window, after the second Esc the cursor comes back on your first click in the
game (a browser security rule: after leaving pointer lock with Esc a new click is required).
| Question over a game | Settings | Light theme |
|---|
| | |
| "Programs" section | "Programs", light theme |
|---|
| |
The app icon is drawn by code: app/assets/logo.svg; npm run icon renders it into
app/assets/icon.ico (16-256 px, with a simplified drawing for 16-32 px) and icon.png.
Run, build, test
Requires Node.js 22 or newer.
npm install
npm start # run the app
npm run dist # build the installer and the portable exe into dist/
The Windows x64 build gives dist/Hub-1.1.3-Setup.exe (NSIS, per-user, no admin
rights, Russian) and dist/Hub-1.1.3-Portable.exe. Only app/ and the
folders of the games, programs and demos go into the build (about 160 MB each).
npm test # web/ pages in Chromium (1193 checks)
npm run test:unit # laws of the app modules and the icon (63)
npm run test:app # the real app through Playwright (91, windows off-screen)
pip install -r requirements-py.txt
python -m pytest tests/py # py/ programs (183)
Helpers: npm run thumbs re-renders the card pictures, npm run screenshots takes the
pictures for this file, npm run probe:background shows what each game does in a
background tab.
npm run single builds dist/hub-single.html: the whole Hub with all games
and system demos in one offline HTML file (about 4.5 MB).
Browser version
index.html at the repository root is the same Hub in a regular browser: the same
cards, descriptions and pictures, games open in tabs of the page, plus a "System demos"
section (win11_3, macos-tahoe, ios26, oneui7). Open it with a double click on
index.html or serve the repository root with any static server. No build, no server and
no internet are needed; all paths are relative.
- One game table for the app and the page:
web/_shared/games-data.js. Tab order and
settings come from the same modules, app/tabs.js and app/settings.js.
- Leaving a game (another tab, the home screen, a hidden browser tab) sends it
{mix: 'pause'}, coming back sends {mix: 'resume'}; the player unpauses.
- All pages of a site share one storage; games keep apart by key prefixes (the
storage
field of the table). "Clear data" erases only the chosen game.
- The volume setting reaches the games when the page comes from a site or server; from
disk the browser treats game pages as foreign, so volume is set in the games.
- GitHub Pages: Settings → Pages → Deploy from a branch →
main, folder / (root). The
.nojekyll file at the root is required, otherwise Pages drops folders starting with
an underscore (web/_shared, web/_launcher, web/_os-shared).
- On a site the page isolates itself (
hub-coi-sw.js, a service worker that adds
COOP/COEP to the Hub's own files only; other sites of the same address stay as they are).
So the Compiler in a tab of the Hub waits for a line typed in its output, as on its own site.
The first visit loads the page once more through the worker.
The page laws are in tests/weblauncher.spec.js (part of npm test): over file:// and
from a server subfolder, as on Pages.
Renaming the app
The name lives in one place: productName in package.json. Both the app (window
title, home screen, About) and the builder (shortcuts, installer) read it. Game data does
not depend on the name and lives in %APPDATA%\MixOfProject-Games, so records survive a
rename. The build file names are set in Latin letters in build.nsis.artifactName and
build.portable.artifactName and can be changed separately if needed.
Pages in web/
Every page is checked by a common law: it opens without errors and without network. Most
pages also have their own laws in tests/web/<name>.spec.js. Detailed reviews (what was
wrong and what was fixed, in Russian) are in docs/audit/games.md
and docs/audit/apps.md. Scores are after the fixes.
Games (scores: fun / polish / originality)
| Folder | What it is | Own laws | Score |
|---|
tetris | Blocks: falling pieces by the classic rules, with hold and T-spins | 12 | 9 / 9 / 4 |
sudoku | Sudoku with a solver, hints, pause and records per level | 11 | 8 / 9 / 5 |
horizon_drift_offline | Horizon Drift: 3D racing and drifting, career, 8 cars and 8 tracks, free roam on 4 maps, car damage; rivals are driven by the AiRacer neural network (it sees only what a driver sees), "New track" from a code - a generator checked by the bot and the network | 118 + 11 in node | 8 / 7 / 7 |
space_shooter | Space Shooter: waves of enemies and asteroids, power-ups, record | 12 | 8 / 7 / 5 |
mario | Hop-Skip: a two-level platformer with its own hero | 13 | 7 / 8 / 5 |
jungle-strike | Fire Jungle: a run-and-gun arcade with a boss | 11 | 7 / 7 / 6 |
minecraft_clone_3d_1 | Cube World: a voxel sandbox, builds are saved | 11 | 7 / 7 / 6 |
dino | Dino Run: jump over cacti and duck under birds | 11 | 6 / 8 / 3 |
rail-runner | RailRunner («Бег по рельсам»): run along three tracks in 3D away from trains through five districts - 6 characters, a shop, missions, a jetpack and a tutorial. Its own repository RailRunner; this is a copy of its web/, version 2.0.3, refreshed with node tools/sync-railrunner.js [folder] (or RAILRUNNER_DIR) | in RailRunner | not reviewed yet |
flappy-wings | Flappy Wings: fly between columns, one file, a fan game not affiliated with the rights holders of the genre's known games | 25 | not reviewed yet |
fps_1 | Operation: Perimeter: a first-person tactical shooter, rounds against bots | 10 | 6 / 7 / 4 |
roblox-mini | Blockcity: a city of places - pick one and dress up your hero |
Tools (score 1-10: usefulness, reliability, completeness)
| Folder | What it is | Own laws | Score |
|---|
writing-speed | WritingSpeed: typing speed test - time, words, texts, custom text, zen; six languages and code; WPM/CPM, accuracy, consistency, mistakes by key, records. Also a separate Electron app (web/writing-speed/electron) | 91 | not reviewed yet |
media-player | MediaPlayer: 12 own songs from a song generator (Web Audio, nothing downloaded), your files (audio and video), playlist, shuffle/repeat, speed, 10-band equalizer, 3 visualizers, mini mode, Media Session, five Paint themes, RU/EN. Also a separate Electron app (web/media-player/electron) and a standalone repository: MediaPlayer | 45 (+23 mutants) | not reviewed yet |
files-manager | FilesManager: a file explorer - folder tree, tiles/list/table, tabs, two panels, wildcard search, preview of images, text, code, audio, video, PDF, Windows Explorer hotkeys, five Paint themes, RU/EN. In the browser: a demo disk in IndexedDB or real folders through the File System Access API. Also a separate Electron app (web/files-manager/electron, disk work over IPC, delete only to the Recycle Bin) and a standalone repository: FilesManager | 9 (+13 mutants, +1 Electron) | not reviewed yet |
compiler | Compiler: C, C++ (Clang 22 → WebAssembly), Python, JavaScript, TypeScript, Lua, Ruby and SQL in the browser; time limit, Stop, stdin and typing input while the program runs, errors on their line, five Paint themes, RU/EN. Also a standalone repository: Compiler | 33 (+27 mutants) | not reviewed yet |
python_ide | Offline Python 3.13: editor, Stop, input(), files | 11 | 8 |
calcpro-glass | Calc Pro Glass («Калькулятор Glass»): Standard, Scientific, Fraction and Programmer (HEX, DEC, OCT, BIN) modes, DEG/RAD/GRAD, memory, history, five Paint themes. A copy of calcpro-glass/src from CalculatorPro, |
Desktop-shell demos (no detailed review yet, only the common law)
| Folder | What it is |
|---|
win11_3 | A Windows 11 style shell |
macos-tahoe | A macOS style desktop |
ios26 | An iOS style phone |
oneui7 | A One UI style phone |
Programs in py/
All use PySide6 with one dark theme. Tests run without a screen
(QT_QPA_PLATFORM=offscreen). Review: docs/audit/py.md.
| File | What it is | Tests | Score |
|---|
paint.py | Image editor: undo, opacity, flood fill, filters | 42 | 8 |
compiler.py | Mini compiler of a small language to Python with clear errors | 63 | 8 |
telegram_clone.py | Chat that keeps its history, with search | 15 | 7 |
explorer.py | File explorer that deletes only to the Recycle Bin and only after asking | 20 | 7 |
os_sim.py | "Python95": a desktop whose windows run the programs above | 21 | 7 |
browser.py | QtWebEngine browser with its own start page | 22 | 6 |
Third-party libraries
They sit next to the pages unchanged, each with its licence text.
| Library | Where | Licence |
|---|
| three.js r149 | web/{fps_1,horizon_drift_offline,minecraft_clone_3d_1,roblox-mini}/vendor/ | MIT |
| CodeMirror 5.65.21 | web/python_ide/vendor/codemirror/ | MIT |
| Pyodide 0.29.5 (Python 3.13.2) | web/python_ide/vendor/pyodide/ (also used by web/compiler) | MPL-2.0; Python standard library: PSF |
| YoWASP Clang 22 (Clang, LLD, wasi-libc, libc++) | web/compiler/vendor/clang/ | Apache-2.0 WITH LLVM-exception; wasi-libc: Apache-2.0/MIT; YoWASP: ISC |
| ruby.wasm 2.10.1 (CRuby 3.4) | web/compiler/vendor/ruby/ | MIT; Ruby: see NOTICE |
| TypeScript 5.9.3 | web/compiler/vendor/typescript/ | Apache-2.0 |
| sql.js 1.14.2 (SQLite) | web/compiler/vendor/sqljs/ | MIT; SQLite: public domain |
| Fengari 0.1.4 (Lua 5.3) | web/compiler/vendor/fengari/ | MIT |
| CodeMirror 5.65.21 modes and hints | web/compiler/vendor/codemirror/ | MIT |
| word lists from wordfreq 3.1.1 (Robyn Speer), filtered | the WORDS block of web/writing-speed/index.html | CC BY-SA 4.0 (that block only) |
The app is built with Electron (MIT) and electron-builder (MIT); tests use Playwright
(Apache-2.0).
Licence
MIT, see LICENSE. All games and programs are fan concepts. Names of other
products in the descriptions are only for comparison; the project is not affiliated with
the rights holders.
