https://github.com/Assios/chessguessr

Guess the continuation of a chess game
https://github.com/Assios/chessguessr

chess firebase firestore game hacktoberfest react remix tailwind tailwindcss typescript wordle

Last synced: about 1 month ago
JSON representation

Guess the continuation of a chess game

• Host: GitHub
• URL: https://github.com/Assios/chessguessr
• Owner: Assios
• License: gpl-3.0
• Created: 2022-06-08T21:48:19.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2025-04-09T20:04:18.000Z (about 1 month ago)
• Last Synced: 2025-04-09T21:21:34.152Z (about 1 month ago)
• Topics: chess, firebase, firestore, game, hacktoberfest, react, remix, tailwind, tailwindcss, typescript, wordle
• Language: TypeScript
• Homepage: https://chessguessr.com
• Size: 2.58 MB
• Stars: 88
• Watchers: 3
• Forks: 10
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# [Chessguessr](https://chessguessr.com)

[![Twitter](https://img.shields.io/twitter/follow/chessguessr?style=social)](https://twitter.com/chessguessr)

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

![](https://chessguessr.com/chessguessr.png)

Chessguessr is a game where you try to guess the next moves in a chessgame. All positions are currently taken from games played on [Lichess](https://lichess.org).

## Rules

Like Wordle, or Chessle, you are given hints after each guess.

- 🟩 indicates that the move is correct.

- 🟨 indicates that the move is correct, but in the wrong place.

- 🟦 indicates that the correct piece type was moved (but not necessarily the exact same piece).

- ⬜ indicates that the move is wrong.

## Development

Chessguessr is built with [Remix](https://remix.run/), Typescript, Tailwind, Firebase (for keeping track of puzzle stats).

## REST API

### Get the daily Chessguessr puzzle

#### Request

`GET https://chessguessr.com/api/daily`

#### Response

The API returns a JSON object with the following properties:

- `date`: The date of the puzzle, in the format "YYYY-MM-DD".

- `fen`: The chess position in FEN format.

- `solution`: An array of moves that represents the solution to the puzzle.

- `id`: The unique ID of the puzzle.

- `boardImage`: an image of the chess board with the puzzle position.

- `players`: An array of objects representing the white and black players in the game. Each player object has the following properties:

  - `color`: The color of the player ("white" or "black").

  - `name`: The name of the player.

  - `rating`: The rating of the player.

  - `title`: The chess title of the player, if any (e.g. "GM" or "WIM").