How anubothu-aravind/pyodide-sudoku works
This is a self-hosted, offline-capable Sudoku web app backed by a Python Sudoku engine, also exposed as a Python library and CLI. The main browser workflow routes a player into campaign or free play, sends generation/solve requests to the Pyodide worker, and renders interactive boards; campaign progress and game state persist locally. Watch Solver presents traced solving as a replay, with an optional naive-solver comparison. README documents campaign, free play, solver inspection, variants, PWA operation, and a CLI; some links to unsampled subsystems are documented rather than source-verified.
Main entry points: LevelsView.tsx Campaign mode · PlayView.tsx Free play · web_api.py Web API facade · App.tsx App router
Components 28
Web experience
- App router
frontend/src/App.tsx - Campaign mode
frontend/src/components/levels/LevelsView.tsx - Free play
frontend/src/components/play/PlayView.tsx - Puzzle board
frontend/src/components/board/Board.tsx - Number pad
frontend/src/components/board/NumberPad.tsx - Solver replay
frontend/src/components/solver/SolverPlayback.tsx - Naive comparison
frontend/src/components/solver/NaiveCompareModal.tsx - Replay engine
frontend/src/solver/replayEngine.ts - Play state
frontend/src/reducers/playReducer.ts
Local state
- IndexedDB storage
frontend/src/storage/db.ts - Record validation
frontend/src/storage/validation.ts - Tab synchronization
frontend/src/storage/sync.ts - Progress import/export
frontend/src/storage/exportImport.ts
Browser runtime
- Worker client
frontend/src/worker/sudokuWorkerClient.ts - Pyodide worker
frontend/src/worker/pyodide.worker.ts - Pyodide runtime
frontend/public/pyodide/pyodide.mjs
Sudoku engine
- Level engine
sudoku/levels.py - Grid model
sudoku/grid.py - Candidate state
sudoku/candidates.py - Logic solver
sudoku/solver.py - Puzzle generator
sudoku/generator.py - Difficulty grading
sudoku/difficulty.py - Solver trace
sudoku/trace.py - Naive solver
sudoku/naive.py - Sudoku variants
sudoku/variants.py
Python interfaces
- Web API facade
sudoku/web_api.py - Python CLI
sudoku/cli.py
Other components
- Player
Connections 35
- Player → App router: opens
- App router → Campaign mode: routes to
frontend/src/App.tsx - App router → Free play: routes to
frontend/src/App.tsx - Campaign mode → Puzzle board: renders
frontend/src/components/levels/LevelsView.tsx - Campaign mode → Number pad: renders
frontend/src/components/levels/LevelsView.tsx - Free play → Puzzle board: renders
frontend/src/components/play/PlayView.tsx - Free play → Number pad: renders
frontend/src/components/play/PlayView.tsx - Free play → Play state: dispatches
frontend/src/components/play/PlayView.tsx - Campaign mode → Worker client: requests puzzles
frontend/src/components/levels/LevelsView.tsx - Free play → Worker client: requests solving
frontend/src/components/play/PlayView.tsx - Campaign mode → IndexedDB storage: loads progress
frontend/src/components/levels/LevelsView.tsx - Campaign mode → Tab synchronization: synchronizes tabs
frontend/src/components/levels/LevelsView.tsx - App router → IndexedDB storage: loads stats
frontend/src/App.tsx - IndexedDB storage → Record validation: validates records
frontend/src/storage/db.ts - Player → Tab synchronization: updates tabs
- Player → Progress import/export: exports progress
- Worker client → Pyodide worker: posts requests
- Pyodide worker → Worker client: returns responses
- Pyodide worker → Pyodide runtime: runs runtime
- Pyodide runtime → Web API facade: invokes facade
- Web API facade → Level engine: requests levels
sudoku/web_api.py - Web API facade → Logic solver: dispatches solving
sudoku/web_api.py - Web API facade → Puzzle generator: generates puzzles
sudoku/web_api.py - Web API facade → Naive solver: dispatches comparison
sudoku/web_api.py - Logic solver → Candidate state: updates candidates
sudoku/solver.py - Candidate state → Grid model: uses grid
sudoku/candidates.py - Logic solver → Solver trace: emits events
sudoku/solver.py - Puzzle generator → Logic solver: checks uniqueness
sudoku/generator.py - Puzzle generator → Difficulty grading: grades puzzles
sudoku/generator.py - Web API facade → Sudoku variants: dispatches variants
sudoku/web_api.py - Free play → Solver replay: shows solver
frontend/src/components/play/PlayView.tsx - Campaign mode → Solver replay: shows solver
frontend/src/components/levels/LevelsView.tsx - Solver replay → Replay engine: scrubs trace
- Free play → Naive comparison: opens comparison
frontend/src/components/play/PlayView.tsx - Web API facade → Python CLI: supports CLI