Freegosy has 713 tests (as of v0.5.10-pre) covering unit logic, widget rendering, and integration scenarios.

flutter test # Full suite (~30s)
flutter test test/unit/ares_strategy_test.dart # Single file
flutter analyze # Lint check (no issues expected)

• flutter_test — core Flutter test framework
• mockito — mock generation via @GenerateMocks annotation
• build_runner — generates .mocks.dart files from annotations
• http_mock_adapter — HTTP/Dio request mocking
• fake_async — async timing control

• Built-in controller mappings validation
• POV decoding (8 cardinal + diagonal directions)
• SDL mapping parser
• Custom mapping persistence (round-trip, corrupt JSON, polarity-encoded keys)
• Deadzone config (defaults, persistence, per-controller overrides)
• PlayStation USB controller entries (PS4, PS5, PS5 Access, Sony ISE Wireless)
• Empty-token fallback for Bluetooth noise-only controller names

• getSystemNameForSlug — correct mapping, case-insensitive, null handling
• supportedSlugs — matches all 30 kAresSystemNames keys
• Args regression — launch calls only pass ['--system', name], no --fullscreen/--no-file-prompt
• Unsupported platform throws for both launch and launchWithHandle

• Extension classification per platform (confirmed/defaulted/log-only)
• State file exclusion (.bs1-.bs9, .rtc)
• Stem-prefix filename matching
• restoreSave directory creation on fresh install

• Slot naming (always "freegosy", not timestamped)
• Autocleanup on legacy push (true, limit 5)
• Force push passes overwrite=true
• Pull cooldown (second pull within 60s is skipped)
• No pruneOldSaves in legacy push

• Exclamation mark sanitization
• Bracket and whitespace handling
• Stem-prefix matching with region/version tags

• Filters .m3u, .cue, .ccd, .mds, .toc, .sub from launchable files

• Folder-based platforms return folder path
• .exe detection in nested folders
• Skips .dll/.xnb as main ROM

• Glob pattern matching (.ini, eeprom., saves/*)
• Empty/whitespace patterns
• Case-insensitive matching

1. Create test/unit/<emulator>_strategy_test.dart
2. Test getSystemNameForSlug (if applicable)
3. Test supportedSlugs completeness
4. Test launch args (no invalid flags)
5. Test unsupported platform throws

1. Add regression test in the relevant *_regression_test.dart file
2. Or create test/unit/<issue>_<feature>_test.dart for issue-specific tests
3. Lock down the exact behavior that was broken

• Use @GenerateMocks([ServiceClass]) annotation
• Run flutter pub run build_runner build to regenerate
• Generated mocks go in <test_file>.mocks.dart
• SharedPreferences mocked via SharedPreferences.setMockInitialValues({})