Repository files navigation

A feature-rich, open-source Sudoku game that rivals commercial applications

🌐Live Demo:https://sudoku.tn1ck.com

Born from a simple request - my Grandma wanted to play Sudoku, but I wasn't satisfied with the available options. This project aims to create an open-source Sudoku experience that matches or exceeds commercial applications, making quality puzzle gaming accessible to everyone.

• 3000 Puzzles: Carefully created puzzles across 5 difficulty levels
• Smart Hints: Get help when you're stuck without spoiling the challenge
• Undo/Redo: Full history tracking with CMD/CTRL + Z & Y shortcuts
• Progress Saving: Never lose your place - automatic save functionality
• Create your own: Design custom puzzles with built-in validation checking

• Smart Notes: Automatic note generation and management
• Custom Notes: Add your own annotations and strategies
• Conflict Detection: Real-time highlighting of errors and conflicts
• Number Tracking: Visual indicators showing number occurrences

• Auto-save: Your progress is automatically saved
• Difficulty Progression: Start easy, work your way up
• Clean Interface: Distraction-free, modern design
• Mobile Responsive: Play on any device

• Node.js (version 20 or higher) -Download here

# Clone the repositorygit clone https://github.com/tn1ck/super-sudoku.gitcd super-sudoku# Install dependenciesnpm install# Start development servernpm start

The app will be available athttp://127.0.0.1:3000

npm run build

Generated files will be in thedist directory.

# Build the imagedocker build -t super-sudoku:latest.# Run the container (map to your preferred port)docker run -p 8081:80 super-sudoku:latest

Ready-to-use images are available atGitHub Container Registry.

Super Sudoku includes a sophisticated puzzle generation system based on research from "Rating and Generating Sudoku Puzzles Based On Constraint Satisfaction Problems."

• generate_sudokus.ts: Generate new puzzles by difficulty level

• User interface for custom puzzle generation
• Community puzzle sharing
• Advanced difficulty algorithms

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

• 🎨 UI/UX improvements
• 🧩 New puzzle generation algorithms
• 🐛 Bug fixes
• 📱 Mobile optimization
• 🌍 Internationalization
• 🎮 New game modes

This project is licensed under the MIT License - see theLICENSE file for details.

• Research paper: "Rating and Generating Sudoku Puzzles Based On Constraint Satisfaction Problems"
• The open-source community for inspiration and tools
• My Grandma for the original motivation! ❤️

Missing a feature?Open an issue and let us know!