Hamduk Chess.
Core Chess Gameplay
Real-time multiplayer — Play live games against other users instantly.
Custom time controls — Bullet, blitz, rapid, classical, increment, delay.
Chessboard UI — Interactive draggable board with smooth animations.
Legal move validation — Prevent illegal chess moves automatically.
Premoves — Queue moves before opponent plays.
Takebacks — Request move undo in casual games.
Draw offers — Offer/accept/reject draws.
Resignation — End lost games instantly.
Abort game — Cancel games before meaningful play starts.
Reconnect system — Restore disconnected games.
Spectator mode — Watch games live without playing.
Board themes — Different board and piece styles.
Move sounds — Audio feedback for moves/captures/check.
Move highlights — Highlight previous/current moves.
Coordinate labels — Show board coordinates.
Blindfold mode — Hide pieces for advanced players.
Analysis board — Review games after completion.
PGN export/import — Download/upload chess game notation.
FEN support — Load custom positions.
Move list — Full notation/history sidebar.
Evaluation bar — Show engine advantage.
Engine lines — Suggested best continuations.
Game replay — Replay moves step-by-step.
Keyboard navigation — Navigate moves using keyboard.
Authentication & User Accounts
User registration — Create accounts with email/social login.
Guest play — Play without account.
Player profiles — Public chess identity pages.
Avatars — Upload profile pictures.
Username customization — Unique player handles.
Online status — Show who is online.
Friends system — Add/remove friends.
Blocking users — Prevent interaction with toxic users.
Follow system — Follow favorite players.
Verification badges — Verified titled/pro players.
Device sessions — Manage logged-in devices.
2FA security — Two-factor authentication.
Matchmaking & Multiplayer
Quick pairing — Instant opponent matching.
Rating-based matchmaking — Match similar skill players.
Custom challenges — Invite friends directly.
Private rooms — Password-protected games.
Rated/unrated games — Choose whether ratings change.
Rematch system — Instant replay against same opponent.
Match queue system — Smart waiting queue.
Region matchmaking — Reduce lag with nearby servers.
AI opponent mode — Play against bots.
Multiplayer variants — Chess960, King of the Hill, etc.
Ratings & Rankings
Elo/Glicko ratings — Skill rating system.
Separate ratings — Different ratings per time control.
Leaderboards — Global/ranked player lists.
Seasonal rankings — Monthly competitive seasons.
Achievement badges — Unlock milestones.
Rank progression — Bronze/Silver/Gold tiers.
Performance stats — Win rate, accuracy, streaks.
Country rankings — National leaderboards.
School/club rankings — Group-based rankings.
AI & Analysis
Stockfish integration — Strong chess engine analysis.
Accuracy scoring — Analyze move quality.
Blunder detection — Highlight mistakes.
Brilliant move detection — Detect strong moves.
Opening explorer — Study openings database.
Endgame tablebases — Perfect endgame solutions.
AI coaching — Explain mistakes in plain language.
Puzzle generation — Auto-generate tactics puzzles.
Best move training — Practice finding engine moves.
Position evaluation — Real-time engine evaluation.
Multi-PV lines — Multiple suggested variations.
Game summaries — AI-written game recaps.
Opponent weakness analysis — Detect player habits.
Engine cloud analysis — Server-powered deep analysis.
Chess Learning Features
Interactive lessons — Guided chess tutorials.
Opening courses — Structured opening training.
Puzzle rush — Solve puzzles against time.
Puzzle battle — Compete in puzzle solving.
Daily puzzle — New puzzle every day.
Endgame trainer — Practice endgames.
Opening trainer — Memorize openings.
AI sparring coach — Personalized training partner.
Study mode — Create/share studies.
Video lessons — Embedded chess education videos.
Coach marketplace — Hire chess coaches.
Training streaks — Daily practice tracking.
Adaptive learning — Difficulty adjusts automatically.
Tournaments & Events
Arena tournaments — Continuous point-based tournaments.
Swiss tournaments — Formal pairings system.
Round-robin tournaments — Everyone plays everyone.
Team battles — Club vs club events.
Tournament brackets — Knockout competitions.
Scheduled events — Future tournament scheduling.
Tournament chat — Communication during events.
Arbiter controls — Tournament management tools.
Pairing generator — Automated pairings.
Prize tracking — Rewards/prize management.
Live standings — Real-time rankings.
Team tournaments — Multi-player team events.
Social Features
In-game chat — Chat during matches.
Emojis/reactions — Quick emotional responses.
Clubs/communities — Create chess groups.
Forums — Discussion boards.
Activity feeds — See friend activity.
Share games — Share replay links.
Social profiles — Showcase achievements/games.
Comment system — Discuss games publicly.
Stream integration — Twitch/YouTube support.
Voice chat — Audio communication.
Anti-Cheat & Fair Play
Engine detection — Detect engine-assisted cheating.
Tab-switch detection — Detect suspicious switching.
Move correlation analysis — Compare moves to engines.
Behavior analysis — Detect unnatural play patterns.
Screen monitoring — Optional proctoring tools.
Fair-play reports — Report suspicious users.
Moderator dashboard — Review flagged accounts.
Cheat confidence score — AI-based suspicion scoring.
Sandbagging detection — Detect intentional rating drops.
Smurf detection — Detect alternate accounts.
Anti-bot systems — Prevent automation abuse.
Streaming & Broadcasting
Live broadcast boards — Stream tournaments live.
Multi-board view — Watch multiple games.
Commentary tools — Add annotations/live comments.
OBS integration — Streamer-friendly overlays.
Camera integration — Facecam support.
Smart highlights — Auto-detect exciting moments.
Replay clips — Save game highlights.
Mobile & UX
Mobile responsive UI — Works on all devices.
PWA support — Install like an app.
Push notifications — Alerts for games/events.
Offline analysis — Analyze without internet.
Gesture controls — Mobile-friendly board interactions.
Dark/light mode — UI theme switching.
Accessibility mode — Better usability support.
Low-bandwidth mode — Optimized for weak internet.
Admin & Moderation
Admin dashboard — Full platform management.
User bans — Restrict abusive users.
Report system — Handle misconduct reports.
Content moderation — Moderate chats/posts.
Audit logs — Track admin actions.
Analytics dashboard — Usage and growth metrics.
Feature toggles — Enable/disable features live.
Payments & Monetization
Premium subscriptions — Paid advanced features.
Ad system — Monetize free users.
Cosmetic store — Sell themes/avatars.
Coach payments — Pay coaches through platform.
Tournament entry fees — Paid competitions.
Donations/tipping — Support creators/streamers.
Advanced / Unique Features
idChess-style board recognition — Detect moves from camera feed.
OTB game broadcasting — Broadcast physical games live.
AR chess mode — Play using AR glasses/camera.
Voice-controlled chess — Hands-free gameplay.
AI assistant — Personalized chess companion.
Smart opening prep — Prepare against opponents.
Tournament anti-cheat AI — Advanced event protection.
Heatmaps — Visualize board tendencies.
Chess social network — Chess-focused social ecosystem.
Collaborative analysis — Analyze with friends together.
Cloud studies — Sync studies across devices.
AI-generated tournaments — Automatically created events.
Real-world club locator — Find nearby chess clubs.
NFT/digital collectibles — Blockchain chess assets.
Multi-language support — International accessibility.
API access — Developers integrate your platform.
Custom bots marketplace — Users create/share bots.
AI commentary — Automated game narration.
Game insights dashboard — Deep analytics on play style.
Smart notifications — AI-prioritized alerts.
Cross-platform sync — Continue games anywhere.
Classroom mode — Chess education for schools.
Exam/arbiter tools — Tournament official utilities.
Physical board integration — Connect DGT boards.
Webcam cheat scanning — Detect suspicious physical behavior.
Opening popularity analytics — Trend analysis for openings.
AI tournament assistant — Automate event management.
Puzzle creator studio — Users create/share puzzles.
Chess news hub — Aggregated chess news/content.
Fantasy chess leagues — Prediction competitions.
Team management system — Manage competitive teams/clubs.
Development
Requires Bun and Node.js 22+.
bun install
cp .env.example .env.local # fill in Supabase, AI Gateway, Paystack and Upstash values
bun run dev # http://localhost:3000
Checks: bun run typecheck, bun run lint, bun run build.
Database
Supabase project hamdukchess-platform (London). Migrations live in supabase/migrations:
supabase link --project-ref mzupxdpbsxlovxwcokla
supabase db push
Deployment
Deployed on Vercel from the main branch. Functions run in London (lhr1), next to the database.
