draughtsground
v1.0.1
Published
lichess.org Chess UI
Downloads
3
Maintainers
Readme
Draughtsground is the opensource draughts UI based on Chessground
It targets modern browsers, as well as mobile development using Cordova.
Features
Draughtsground 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
Installation
npm install --save chessground
Usage
var Chessground = require("chessground").Chessground;
var ground = Chessground(document.body, config);
Documentation
Developers
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