// the find
lichess-org/mobile
Lichess mobile app
The official Lichess mobile app, a Flutter/Dart rewrite of the previous React Native client. It's the production app used by millions of Lichess players on Android and iOS, covering gameplay, puzzles, analysis, broadcasts, and more. This is a real-world, actively maintained Flutter codebase worth studying.
- Genuinely active development with recent commits (2026-05-11) and proper CI/CD pipelines including Play Store deployment via Fastlane and F-Droid publishing docs.
- Includes a CLAUDE.md file explaining the codebase for AI-assisted development, which doubles as solid onboarding documentation alongside the /docs directory — contributor experience is clearly taken seriously.
- Uses build_runner with code generation, Riverpod-style state management patterns, and strict analysis_options.yaml, indicating the codebase has real architectural discipline rather than ad-hoc Flutter spaghetti.
- F-Droid support with documented publish process means they're shipping a truly open build, not just open source theater.
- Releasing is locked to lichess team members only — contributors can submit PRs but cannot cut releases, which limits the open-source participation model despite the welcoming CONTRIBUTING.md.
- The app requires a running Lichess backend; there's no offline mode or mock server documented for contributors, so testing real gameplay flows requires a live network connection to lichess.org.
- Heavy reliance on code generation (build_runner) means fresh contributors hit a non-obvious 'dart run build_runner build' step before anything compiles — the README mentions it but it's still a friction point that breaks the standard 'clone and run' expectation.
- No visible unit or integration test coverage metrics, and the test suite likely covers UI widgets more than the chess logic plumbing, making it hard to evaluate how safe changes to game-critical code actually are.