♟ ChessLens

A clean, zero-dependency chess.com stats viewer — runs straight from Node.js.

---

What is it?

ChessLens pulls live data from the chess.com Public API and renders a beautiful, mobile-ready stats dashboard — no npm install, no bundler, no framework. Just Node.js and a browser.

---

Screenshot

┌─────────────────────────────────────────────────-┐
│ ♟ Chess Stats — yournickname │
│ [ username input ] [ Search ] │
├──────────┬──────────┬──────────┬─────────────────┤
│ ⚡ Bullet│ 🔥 Blitz │ ⏱ Rapid │ 📅 Daily │
│ 1204 │ 1350 │ 1480 │ 1560 │
│ W/D/L │ W/D/L │ W/D/L │ W/D/L │
│ ████░░ │ ████░░ │ █████░ │ █████░ │
└──────────┴──────────┴──────────┴─────────────────┘
♟ Tactics Best 🧩 Puzzle Rush

---

Features

• Live ratings — Bullet, Blitz, Rapid, Daily — current + personal best
• W/D/L breakdown with animated win-rate progress bar
• Tactics & Puzzle Rush best scores
• Username via query param — ?u=yournickname — shareable links that always work
• Player comparison — ?u=playerone&v=playertwo for side-by-side mode metrics
• In-page search form — search and compare without URL editing
• Responsive layout — looks great on iPhone SE and a 4K monitor alike
• Dark theme — easy on the eyes, chess.com-inspired gold accents
• Zero dependencies — uses only Node.js built-in modules (http, https, url)
• Input validation — sanitized output, safe username format check

---

Quick Start

# clone or navigate to the foldercd chess-stats
# run — no npm install needed
node index.js
# open in browser
open http://localhost:3000/?u=yournickname

---

Usage

Method	Example
Query param	http://localhost:3000/?u=magnuscarlsen
Compare via query params	http://localhost:3000/?u=magnuscarlsen&v=hikaru
In-page form	Type player 1 (+ optional player 2) → hit Search
Default port	3000
Custom port	PORT=8080 node index.js

---

Stats Displayed

Category	Current Rating	Best Rating	Wins	Draws	Losses	Win %
⚡ Bullet	✅	✅	✅	✅	✅	✅
🔥 Blitz	✅	✅	✅	✅	✅	✅
⏱ Rapid	✅	✅	✅	✅	✅	✅
📅 Daily	✅	✅	✅	✅	✅	✅
♟ Tactics	—	✅	—	—	—	—
🧩 Puzzle Rush	—	✅ (score)	—	—	—	—

---

API

Data is fetched from the official chess.com public API (no API key required):

GET https://api.chess.com/pub/player/{username}/stats

All requests are made server-side — no CORS issues, no API keys exposed to the client.

---

Requirements

• Node.js v18 or later (uses URL global, https.request)
• Internet access to reach api.chess.com

---

Project Structure

chess-stats/
└── index.js # everything — HTTP server, API fetch, HTML rendering

Single-file by design. No build step, no config, no boilerplate.

---

License

MIT — do whatever you want with it.

---

Built with ♟ and zero npm packages.