Chess Games

Source of my chess site at chess.ruialves.net. It lists the tournaments I played, their games with a board to replay them move by move, and my FIDE and Lichess ratings.

Development

Requires Node.js 24 (LTS). mise.toml and .nvmrc pin it for mise and nvm, and Cloudflare Pages reads .nvmrc for its builds.

npm install
npm run dev      # local server at http://localhost:4321
npm run build    # static site in dist/
npm run preview  # serve the build locally
npm run check    # type-check the project

Add a tournament

Add an object to data/events.json. Dates use the DD-MM-YYYY format, and fields without a value are null:

{
  "name": "Torneio Interno GXP 2026",
  "date": "10-01-2026",
  "finishDate": "14-02-2026",
  "location": { "name": "GX Porto, Porto, Portugal", "gmaps": "https://maps.app.goo.gl/..." },
  "page": "https://chess-results.com/...",
  "category": "Classic",
  "timeControl": "90m + 30s",
  "team": false,
  "rated": true,
  "ratingDiff": "+12.4",
  "performance": 1900,
  "numPlayers": 30,
  "rank": 5,
  "score": "5.0 / 7",
  "notes": "Optional comments about the tournament."
}

• category is Classic, Rapid or Blitz.
• The tournament is published at /tournament/<name in lowercase, with dashes>/.

To add its games, add one object per game to data/games.json:

• event must be the tournament's name.
• pgn holds the moves, like 1. e4 e5 2. Nf3 Nc6 ... 1-0.
• result is white, black or draw, and view is the color I played.
• lichess_url is the game on Lichess, or null.

Each game with moves gets a page at /tournament/<tournament>/round-<round>/. The page has a board to replay the game, a PGN download, and a button to copy the position as FEN. To link to a position, add ?move=<n> to the URL.

The build checks both files and fails on a missing or wrong field. It also makes the social preview images and the sitemap entries.

Ratings

The build reads the ratings when it runs:

• FIDE ratings and their monthly history come from my FIDE profile.
• Lichess ratings come from the Lichess API.

If a source is not available, the build still passes and the site says so.