lichess mobile

Official lichess.org mobile application for Android & iOS.

Play bullet, blitz, classical, and correspondence chess
Play in arena tournaments
Find, follow, challenge players
See your games stats
Practice with chess puzzles
Many variants, available online and offline: Crazyhouse, Chess 960, King Of The Hill, Three-check, Antichess, Atomic chess, Horde, Racing Kings!
Game analysis with local computer evaluation
Play against offline computer
Over The Board mode to play offline with a friend
Standalone chess clock with multiple time settings
Board editor
Available in 80 languages
Designed for both phones and tablets, supporting landscape mode
100% free, without ads, and opensource!

Lichess mobile is written in JavaScript (ES6), with the help of cordova and mithril.js. It uses babel, browserify, gulp and tarifa as build tools. It talks to a native Stockfish interface through a cordova plugin and uses an async chess worker which is based on lichess scalachess module compiled to JavaScript.

Requirements

node v5.x
gulp version 3.9.x
tarifa latest version

Android:

the android SDK
SDK packages API 23
last version of Android SDK tools and platform tools
android ndk for stockfish compilation
make sure the sdk/tools/ directory is in your path, so you can use android command everywhere.

iOS:

OS X and Xcode version 7.x

Init project after checkout

$ tarifa check --force

This will recreate the cordova folder with android and iOS platforms and also install plugins.

Build the web application

Make sure you installed all deps:

$ cd project
$ npm install

Then copy project/env.json.example to project/env.json and modify settings to link your app to a lichess server.

To build in dev mode:

$ gulp

To build and watch for changes:

$ gulp watch

To run in a browser it needs to have web security disabled for loading files and make requests to lichess. For mouse interaction you need to use device mode

Launch chrome with disabled security under linux

$ chromium --user-data-dir=$HOME/.chromium_dev_dir --disable-web-security

Launch chrome with disabled security under OSX

$ open -n -a Google\ Chrome --args --disable-web-security --user-data-dir=/Users/myUser/.chrome_dev_dir

Build stockfish

Android

Build the native code using:

ndk-build -C app/platforms/android

iOS

Through XCode, in the build settings menu:

Set C++ Language Dialect option to C++11 value.
Set C++ Standard Library option to lib++ value.

Build and run on your device

Connect your device with USB debugging enabled and:

$ tarifa run [platform]

This will use the default configuration which use a development lichess server end point.

Please look at tarifa documentation for further documentation.

ornicar/lichobile