Turn your games into training

VelaChess imports your chess games, builds a repertoire from your play, and turns useful positions into spaced-repetition exercises.

Try VelaChess · Documentation · Self-host

How it works

Chess.com / Lichess games / PGN Import
  ├─→ Repertoire → decision positions and deviations ───────────────┐
  └─→ Open a game → Stockfish (on demand) → engine-flagged mistakes ┤
                                                                    ↓
                                                                Exercises
                                                                    ↓
                                                                FSRS review

Quick start

Requires Node.js 22 or later, pnpm via Corepack, and Docker.

cp .env.example .env

pnpm dev:setup
pnpm dev

Open http://localhost:5173. See Running locally for the full development setup or Self-hosting for deployment.

Documentation

Start with the documentation index, or go directly to:

• Guided first run
• Architecture and repository layout
• Domain reference and API design
• Self-hosting
• Verifying a change

Contributing

Contributions are welcome. See CONTRIBUTING.md for setup, conventions, and contribution guidelines.

Security

Found a vulnerability? Please follow SECURITY.md instead of opening a public issue.

License

See the LICENSE file for licensing information.