Customise your Lichess board with custom user styles
Lichess Tailor is a web tool for generating custom user styles for lichess.org. Customise board colours, overlay highlights, and more with a live interactive preview. Export your style directly to Stylus, download it, or share it with others via a URL.
Self-hosting:
- Docker
- nginx
- PHP 8.0+
Using generated styles:
- Clone the repository
git clone https://github.com/mobeigi/lichess-tailor.git
- Start the Docker containers
docker compose up -d
- Visit the site, choose a preset or customise colours and overlays.
Lichess Tailor supports applying SVG textures to light and dark squares independently. Only .svg files are accepted; raster image formats (PNG, JPG, etc.) are not supported.
SVG textures can be found across many free and paid resources online. Flaticon is a recommended starting point with a large library of SVG icons and patterns available for download.
If you have a raster image (PNG, JPG, etc.) that you want to use as a texture, it can be converted to SVG using an online tool such as PicSVG. Note that conversions from raster images are approximate; simple high-contrast images tend to convert best.
SVG files sourced from the web often contain unnecessary metadata, editor comments, and redundant attributes that inflate their size. It is highly recommended to optimise your SVG before uploading to keep performance snappy and share/install URLs manageable. Good tools for this include:
- SVGOMG: a feature-rich optimiser with fine-grained control
- SVG Viewer: lets you view, edit, and optimise SVGs in the browser
Contributions are always welcome!
Just make a pull request.
Lichess Tailor is licensed under the GNU General Public License v3.0 (GPL-3.0).
This project utilizes Lichess Chessground for rendering the chessboard. Chessground is licensed under the MIT License.