Blunder Detector

Move Analysis Engine
Learn from your mistakes. Play better chess.

---

What is this?

A chess game analyzer with Stockfish 16 under the hood and a retro Windows 95 UI because... why not?

Paste your PGN. Get instant feedback on every blunder, mistake, and inaccuracy. Become a better player.

---

Features

Feature	Description
Deep Analysis	Stockfish 16 evaluates every move
Move Classification	Blunders • Mistakes • Inaccuracies
Chess Tutor	Real-time explanations with best move suggestions
Retro Design	Windows 95 aesthetic, because nostalgia

---

Setup

Prerequisites

• Flutter SDK 3.10+
• Docker (for Stockfish backend)

1. Start the Engine

docker run -p 8000:8000 stockfish-api

2. Launch the UI

cd mae_chess_ui
flutter run -d chrome --web-port=8080

3. Analyze

1. File → Load PGN
2. Paste your game
3. Use ← → arrows to navigate
4. Learn from your mistakes

---

Controls

Key	Action
←	Previous move
→	Next move
Home	First move
End	Last move

---

Architecture

mae_chess_ui/          Flutter Web App
     │
     │  HTTP/REST
     ▼
stockfish-api          Docker Container
     │
     │  UCI Protocol
     ▼
Stockfish 16           Chess Engine

---

Aesthetics

"The Windows 95 UI makes losing at chess feel nostalgic."

• Chess.com-style board colors
• Color-coded moves (🔴 blunder • 🟡 mistake • 🟠 inaccuracy)
• Typewriter effect tutor console
• Classic beveled buttons and panels

---

Tech Stack

• Frontend: Flutter Web
• Engine: Stockfish 16
• Backend: FastAPI + Docker
• Chess Logic: chess package for Dart

---

Built with love (for the sake of chess) and questionable UI decisions