TypeScript JavaScript Shell
Clone or download
ornicar Merge pull request #80 from topce/ts28
change TypeScript version to 2.8
Latest commit 7c46fe1 May 10, 2018


Chessground in 2D and 3D

Chessground is the opensource chess UI developed for lichess.org.

It targets modern browsers, as well as mobile development using Cordova.



Chessground is designed to fulfill all lichess.org web and mobile apps needs, so it is pretty featureful.

  • Well typed with typescript
  • Fast. Uses a custom DOM diff algorithm to reduce DOM writes to the absolute minimum
  • Small footprint: 10K gzipped (30K unzipped). No dependencies.
  • SVG drawing of circles and arrows on the board
  • Entirely configurable and reconfigurable at any time
  • Styling with CSS only: board and pieces can be changed by simply switching a class
  • Fluid layout: board can be resized at any time
  • Support for 3D pieces and boards
  • Full mobile support (touchstart, touchmove, touchend)
  • Move pieces by click
  • Move pieces by drag'n drop
    • minimum distance before drag
    • centralisation of the piece under the cursor
    • piece ghost element
    • drop off revert or trash
  • Premove by click or drag
  • Drag new pieces onto the board (editor, crazyhouse)
  • Animation of pieces: moving and fading away
  • Display last move, check, move destinations, and premove destinations (hover effects possible)
  • Import and export positions in FEN notation
  • User callbacks
  • No chess logic inside: can be used for chess variants


npm install --save chessground


var Chessground = require("chessground").Chessground;

var ground = Chessground(document.body, config);



First of all, of course:

yarn install

To build the node module:

tsc -watch

To build the standalone:

gulp dev  // build once
gulp      // build and watch
gulp prod // build minified