https://github.com/lichess-org/mobile
Lichess mobile app written in Flutter
https://github.com/lichess-org/mobile
android chess dart flutter ios lichess mobile
Last synced: 11 days ago
JSON representation
Lichess mobile app written in Flutter
- Host: GitHub
- URL: https://github.com/lichess-org/mobile
- Owner: lichess-org
- License: gpl-3.0
- Created: 2022-05-01T10:26:50.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2026-04-25T10:19:56.000Z (18 days ago)
- Last Synced: 2026-04-25T10:26:11.562Z (18 days ago)
- Topics: android, chess, dart, flutter, ios, lichess, mobile
- Language: Dart
- Homepage:
- Size: 125 MB
- Stars: 2,230
- Watchers: 33
- Forks: 400
- Open Issues: 443
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: COPYING.md
Awesome Lists containing this project
README
# Lichess Mobile
Second iteration of the [Lichess mobile app](https://lichess.org/mobile).
## How to contribute
Contributions to this project are welcome!
If you want to contribute, please read the [contributing guide](./CONTRIBUTING.md).
If you are new to this project, you can [read the documentation](./docs) to get
started. The [CLAUDE.md](./CLAUDE.md) is also a good resource to understand the
codebase.
## Setup
tl;dr: Install Flutter, clone the repo, run in order:
- `flutter pub get`
- `dart run build_runner watch`
- `flutter analyze --watch`,
and you're ready to code!
See [the dev environment docs](./docs/setting_dev_env.md) for detailed instructions.
## Running the app
To run the app, you can use the following command:
```bash
# if not already done, run the code generation
dart run build_runner build
# run the app on all available devices
flutter run -d all
```
## Running tests
To run the tests, you can use the following command:
```bash
# if not already done, run the code generation
dart run build_runner build
flutter test
```
## Internationalisation
Do not edit the `app_en.arb` file by hand, this file is generated.
For more information, see [Internationalisation](./docs/internationalisation.md).
## Releasing
Only for members of lichess team.
1. Bump the pubspec.yaml version number. This can be in a PR making a change or a separate PR. Use semantic versioning to determine which part to increment. The version number after the + should also be incremented. For example 0.3.3+000303 with a patch should become 0.3.4+000304.
2. Run workflow [Deploy to Play Store](https://github.com/lichess-org/mobile/actions/workflows/deploy_play_store.yml)
3. [Publish on F-Droid](./docs/publish_fdroid.md)