Teletype Games is an independent game development collective. We make small retro-flavoured games on eight platforms — from Go and Godot to the Commodore 64 — and we build the whole road they travel: a CI pipeline that turns a push into a release, a public catalog where every title plays in the browser or downloads for desktop, and stores that carry the catalog onto a Batocera box, into RetroArch or onto a desktop. This wiki documents all of it. The engineering pages are public; the team and project pages need a login.
| Stage | What happens | Read |
|---|---|---|
| 1. A game repo | A project on our Gitea holds its sources and a one-line .woodpecker.yaml marker naming its platform. |
Platforms |
| 2. The pipeline | Woodpecker asks the catalog server, and WarpEngine serves the whole build config: version, build, package, upload, publish. The builder images live server-side. | WarpEngine, Deployment |
| 3. The catalog | The release lands on teletypegames.org: a web build to play in the browser, native zips to download, a cartridge for real hardware. | Public site |
| 4. The stores | The same catalog is installed onto a Batocera box, rendered as RetroArch playlists, or browsed in the desktop client. | Stores |
| 5. The shop | Teletype Orbit puts prices, entitlements and gated downloads on top of the catalog, with the same client on the other end. | Teletype Orbit |
Every platform page has the same shape: how a project is laid out, the Makefile for local work, the served pipeline step by step, and what the release carries.
| Platform | Language | What a release carries |
|---|---|---|
| Ebitengine | Go | Web build, Windows and Linux binaries; macOS by hand |
| Bevy | Rust | Web build, Windows and Linux binaries |
| Godot | GDScript / C# | Web build, Windows, Linux and a universal macOS build |
| LÖVE | Lua | Web build via love.js, Windows, Linux and macOS |
| Phaser | JavaScript | Web build — no compilation at all |
| TIC-80 | Lua | Cartridge, source, docs, web build and native players |
| Commodore 64 | 6502 assembly | .prg cartridge, a browser player and native players for Linux, Windows and macOS |
| Commodore Plus/4 | 6502 assembly | The same as the C64, on the 264 series |
Alongside the platforms: LibreSprite and Pixelorama for pixel art, and the RoR Styleguide, the rules our Rails applications follow.
The reusable parts, each its own repository and product.
| Engine | Language | What it is |
|---|---|---|
| WarpEngine | Ruby | Mountable Rails engine: the retro software catalog, the CI pipeline server, the build endpoints and the public JSON API behind the public site and Teletype Orbit |
| warpstore | Python | The shared core of the store engines: one dependency-free file that knows a WarpEngine catalog |
| Inkwell | Go | Point-and-click adventure framework on Ebitengine, a SCUMM-era skeleton as a thin DSL |
| RuBBS | Ruby | Framework for Synchronet-style Telnet BBS servers, behind our own Teletype BBS |
How the catalog reaches a player's machine.
| Store | Runs on | What it does |
|---|---|---|
| WarpEngine Client | Windows, Linux, macOS | Desktop app: the catalog as a grid of cards, with the store engine built in |
| WarpEngine Batocera Store | Batocera | Installs a catalog into the ROM folders under its own EmulationStation menu |
| WarpEngine RetroArch Store | Anything RetroArch runs on | Renders a catalog as .lpl playlists with box art |
| TTG Batocera Store, TTG RetroArch Store | — | Our own store definitions on top of the two engines |
| Page | What it covers |
|---|---|
| Server | The self-hosted box: Nginx, Traefik, Gitea, Woodpecker and the rest |
| Deployment | Docker Compose architecture and the CI/CD path from push to running service |
| Public site | teletypegames.org: the Rails catalog API and the retro-styled frontend |
| Teletype Orbit | The shop platform on WarpEngine: purchases, entitlements, gated downloads |
| Wiki Site | This wiki: Grav, the git-backed content, the fetcher, the JSON API, the two languages |
| BBS Network, TTG Wiki BBS | Our telnet boards, from the Teletype BBS on; this wiki on a telnet line |
| Backup, ResourceSpace | Off-site backups; the asset library for artwork and media |
These sections need a login.
| Page | What it is |
|---|---|
| Discord Updater Bot | Polls the wiki, Redmine and Gitea and announces new activity on Discord |
| Discord Thread Scheduler | Opens the weekly meeting thread at a set time |
| Paper Sketch | A guide to designing a game on paper before touching a tool |
| Useful materials | Curated indie articles, films and funding sources |
Gitea · Woodpecker CI · teletypegames.org · Redmine · Uptime Kuma · ResourceSpace