Universal Gaming

Universal Gaming is a cross-platform Flutter game collection: eleven games in one offline-first app for Android, iOS, macOS, Windows, Linux and the web, available in English, German, Spanish, French and Italian.

The app is open source at Emily/UniversalGamingApp. The optional account and leaderboard service lives in Emily/UniversalGamingApp-Backend.

Current version

Item	Value
App version	2.12.2+35
Backend compatibility	1.5.0
Flutter / Dart	3.47.9 / 3.13.7
Hosted web app	https://games.emilyh.de
Latest release	https://git.emilyh.de/Emily/UniversalGamingApp/releases/latest

Start here

• Getting Started — install, first run and optional accounts.
• Games — rules, controls and what makes each game different.
• Features — leaderboard, accounts, updates, Discord Rich Presence and accessibility.
• Building — Flutter builds for every target, signing and Discord setup.
• Architecture — source layout, state, storage and services.
• Testing — test suites, commands and what is covered.
• Deployment — hosted web build, Docker images and release flow.
• Troubleshooting — common install, build and runtime issues.

Design principles

• Speaks your language. English, German, Spanish, French and Italian, following the system language.
• Offline first. Every game runs without a network connection. Saves, settings, statistics and the local leaderboard stay on the device.
• Accounts are optional. A free account is only needed for online chess, submitting to the competitive leaderboard and backing up saved games.
• No ads or tracking. There are no analytics SDKs and no advertising identifiers.
• Optional backups. Saved Sudoku and Killer Sudoku games can be stored on the account server and restored on another device.
• Endless puzzles. Sudoku and Killer Sudoku are generated on-device and checked for exactly one solution.
• Winnable deals. Klondike, Classic Solitaire and FreeCell deals are verified with a solver while they are generated.
• Self-hostable. The web build is static files; the optional backend ships as a container image with PostgreSQL.

Repository map

Path	Purpose
lib/	Flutter app: games, screens, models, services and widgets
test/	Unit, widget and layout tests
android/, ios/, macos/, windows/, linux/, web/	Platform runners
deploy/	Docker, Nginx and Caddy examples for the web build
INSTALL.md	Step-by-step installation and signing guide
WEB_HOSTING.md	Self-hosting the web build

The backend documentation is in the backend wiki.