0001. Стек: TypeScript, веб-отрисовка, упаковка в приложения
Дата: 2026-11-17 · Статус: принято
Контекст
Нужна пошаговая 4X-игра для Steam (Windows, macOS) и App Store (iPhone, iPad), которую разрабатывают два агента (Claude Code, Codex) в терминале. Важно быстро проверять изменения тестами и видеть результат; у 4X много интерфейса (панели, таблицы, отчёты).
Решение
Монорепозиторий TypeScript (pnpm): ядро правил на чистом TS; отрисовка карты — PixiJS, панели — HTML/CSS; Steam — обёртка Electron + steamworks.js; iOS — Capacitor. Тесты — Vitest.
Последствия
- Тесты и симуляции партий идут за секунды из терминала; игру можно открыть в браузере.
- На iPhone игра работает в WebView — производительность проверяется рано (M1.5, большая карта на реальном устройстве).
- Ядро не зависит от отрисовки: при проблемах на телефоне меняется только слой отрисовки.
- Оверлей Steam в Electron требует настройки — проверяется в M1.5.
Отвергнутые варианты
- Godot 4: много работы в визуальном редакторе, который агенты не видят; сложный интерфейс делать медленнее.
- Unity: завязка на редактор, плохо читаемые агентами сцены, история изменения лицензии.
- Свой движок на C++/SDL: в разы медленнее разработка без выигрыша для пошаговой игры.
- Tauri вместо Electron: хуже отработана связка со Steam и оверлеем.