offline_games 0.1.0
offline_games: ^0.1.0 copied to clipboard
A plug-and-play mini arcade for Flutter apps when the device goes offline. Zero-config, dependency-free games, with author credits.
Changelog #
All notable changes to offline_games will be documented in this file.
0.1.0 #
Added #
- Zero-Config Arcade Host (
OfflineGames):- Simple
MaterialApp.builderdrop-in (OfflineGames(child: child!)). - Non-intrusive, dismissible offer card shown once per offline episode.
- Subtle "Back online • Keep playing / Return to app" banner when connection restores during gameplay.
- Intercepts system back buttons to cleanly dismiss game overlays before popping the host app.
- Safe suppression support via
suppressparameter (e.g. during payment checkouts). - Instant simulator testing via
debugForceOffline: truewithout toggling device Wi-Fi.
- Simple
- Presentation Modes (
GamesMode):GamesMode.spin(): Animated slot wheel with guaranteed no-repeat selection.GamesMode.picker(): Modern 8-bit arcade grid catalog showcasing high scores and author credits.GamesMode.single(game): Directly launches a specific chosen mini-game.
- Three Built-in Launch Mini-Games:
- 🧱 Breakout: Classic brick-breaker with angle deflection physics, multi-lives, rainbow brick rows, launch prompts, and touch steering.
- 🃏 Memory Match: Vintage 8-bit card pair flip matching with moves/pairs scoreboard HUD and stage cleared celebration.
- 🐍 Snake: Classic Nokia-style retro arcade snake with smooth motion, directional swipes, and tactile D-pad controls.
- Balanced Neo-Brutalist 8-Bit Visual System:
- High-contrast pure white arcade cards (
#FFFFFF) with solid 2-3px black borders (#000000) and hard stepped drop shadows across both dark and light modes. - CRT monitor atmosphere with subtle scanlines and radial perimeter vignette (
CrtScanlinesOverlay). - Retro 8-bit pixel cloud wipe transition (
RetroCloudTransition). - Pure vector 5x7 bitmask typography (
PixelText) with zero.ttfor.otffont dependencies. - Pure vector 8-bit glyph sprites (
PixelGlyphWidget) with zero Material icons and zero emoji literals.
- High-contrast pure white arcade cards (
- Mandatory Author Attribution:
- Every game openly attributes its creator(s) in picker cards, spin highlights, and the in-game credits modal.
- Standalone Component APIs:
GameSpinner: Standalone random game selector widget with reduce-motion accessibility.GamePicker: Standalone game catalog grid.GamePlayer: Standalone player widget for embedding games into custom views.showOfflineGames(): Imperative helper to push the arcade over any modal route.RetroPixelCard&RetroPixelButton: Reusable neo-brutalist retro UI primitives.
- Developer & Contributor System:
llms.txt: Comprehensive AI assistant documentation for Copilot, Cursor, Gemini, and Claude.tool/game_template/: Copy-pasteable boilerplate for new games.tool/check_authors.dart: Automated CI guard enforcing author attribution, unique IDs, and metadata validity.tool/check_pixel_theme.dart: Automated CI guard enforcing 100% pure pixel vector guidelines.tool/gen_gallery.dart: Automated markdown gallery generator.doc/CONTRIBUTING_GAMES.md: Comprehensive <1 hour contribution guide.