windy-sudoku
Peter Forisbuild me a deployable simple sudoku application
Comments (0)
Sign in to leave a comment
Project Tasks9
Implement Theme and Structure
As a Frontend Developer, I want to implement the global color theme and layout structure from the mock-design pages so that all pages look exactly identical to the designs. Apply the windy-sudoku color palette: Background #F7F9FC, Surface #FFFFFF, Text #2C3E50, Accent #3498DB, Muted #BDC3C7. Set up global CSS variables, fonts, and base layout components. Remove any pages not present in the design (e.g. login, signup, welcome, dashboard/overview, dashboard/ai-assistant, dashboard/settings). Retain only: Home, Game, Result pages.
Implement Puzzle Generation API
As a Backend Developer, I want to implement a FastAPI endpoint for puzzle generation so that the frontend can request Sudoku puzzles of varying difficulty levels (Easy, Medium, Hard). The API should generate a valid, solvable 9x9 Sudoku grid with the appropriate number of pre-filled cells per difficulty. Endpoint: GET /api/puzzle?difficulty={easy|medium|hard}. Returns the grid state as a JSON array.
Implement Solution Validation API
As a Backend Developer, I want to implement a FastAPI endpoint for solution validation so that users can validate their completed Sudoku puzzle. The API should accept the current grid state and return whether the solution is correct or indicate which cells are incorrect. Endpoint: POST /api/validate. Returns validation result and optional error cell positions.
Build Home Page
As a Frontend Developer, I want to implement the Home page based on the existing JSX design (Home v2) so that users can view the landing screen, see the animated windy grid effect, and select a difficulty level (Easy, Medium, Hard) to start a puzzle. The page should include: the animated Sudoku grid background with gentle swaying effect, drifting clouds background animation, difficulty selector, and a start button. This page links to the Game page upon difficulty selection.
Build Game Page
As a Frontend Developer, I want to implement the Game page based on the existing JSX design (Game v2) so that users can play a Sudoku puzzle. The page should include: the interactive 9x9 grid with cell hover flutter animation, number input controls, erase/clear button, a live timer, validate solution button, and reset puzzle button. Wind-sweep transition animation when resetting. Cells glow with accent color #3498DB on number input. This page is reached from Home and links to Result on successful validation.
Build Result Page
As a Frontend Developer, I want to implement the Result page based on the existing JSX design (Result v2) so that users can view their puzzle outcome and solve time after completing a puzzle. The page should display: outcome message (success/fail), total solve time, and navigation options to return to Home or start a new puzzle with a selected difficulty. Links back to Home or Game page.
Integrate Game Page with APIs
As a Frontend Developer, I want to integrate the Game page with the backend puzzle generation and validation APIs so that users receive real puzzles and can validate their solutions. Connect the difficulty selection from Home to fetch a puzzle via GET /api/puzzle, wire up the validate button to POST /api/validate, and handle API responses to show error cells or navigate to Result page on success.
Implement Windy Animations
As a Frontend Developer, I want to implement the signature windy animations across the application so that the experience feels dynamic and alive. Includes: grid sway animation on Home, cell flutter on hover, wind-sweep transition on puzzle reset, cell glow micro-interaction on number input, and looping drifting clouds background animation. Use CSS keyframes and React animation hooks. Must not impact performance on mobile.
Ensure Responsive and Accessible UI
As a Frontend Developer, I want to ensure all pages are fully responsive and meet WCAG 2.1 accessibility standards so that the application works seamlessly on both desktop and mobile devices. Includes: responsive grid layout, touch-friendly cell input on mobile, keyboard navigation support, ARIA labels, sufficient color contrast ratios, and screen reader compatibility.
Solve Sudoku, Feel the Breeze
A clean, calming Sudoku experience. Challenge your mind with puzzles that sway gently like a breeze — focus, relax, and solve.
Choose Your Challenge
Select a difficulty level that matches your mood. Whether you want a gentle breeze or a full gust, we have the perfect puzzle for you.
Easy
Estimated: 8 - 15 minPerfect for beginners. Enjoy a relaxing puzzle with plenty of given numbers to guide you through.
- ✓More pre-filled cells
- ✓Great for learning
- ✓Relaxed pace
Medium
Estimated: 15 - 30 minA balanced challenge for those who know the basics and want to sharpen their logical thinking.
- ✓Moderate complexity
- ✓Requires strategy
- ✓Satisfying to solve
Hard
Estimated: 30 - 60 minFor seasoned solvers seeking a real test. Fewer clues, more deduction, and deeper satisfaction.
- ✓Minimal clues given
- ✓Advanced techniques
- ✓Ultimate brain workout
See the Puzzle in Action
A clean, calming grid designed for focus
Try your hand at our puzzle generator.
Why You Will Love Playing
A clean, calming Sudoku experience designed to help you focus, relax, and enjoy every puzzle.
Multiple Difficulty Levels
Choose from Easy, Medium, or Hard puzzles tailored to your skill level. Whether you are a beginner or a seasoned solver, there is always a fresh challenge waiting for you.
Real-Time Timer
Track your solving speed with a built-in timer. Challenge yourself to beat your personal best and watch your skills improve over time.
Instant Validation
Get immediate feedback on your inputs. Cells glow with a calming blue accent when correct, helping you stay focused and confident as you solve.
Built for Every Player
Whether you solve a puzzle a week or ten a day, Windy Sudoku is crafted to match your pace and style.
Casual Player
Enjoys solving Sudoku puzzles occasionally for relaxation or a quick mental exercise between tasks.
✓Goals
- Solve puzzles at my own pace without pressure
- Enjoy a clean, distraction-free interface
- Unwind with a quick mental exercise during breaks
⚠Pain Points
- Overly complex interfaces with unnecessary features
- Cluttered screens that break concentration
Enthusiast
Regularly solves Sudoku puzzles and actively seeks tougher challenges to sharpen problem-solving skills.
✓Goals
- Access puzzles of varying difficulty to stay challenged
- Track solving time to measure improvement
- Push personal bests on harder puzzles
⚠Pain Points
- Lack of difficulty options or progression
- No performance tracking or solve-time history
What Our Players Say
Join thousands of puzzle lovers who enjoy their daily Sudoku with us.
“Windy Sudoku is my go-to for unwinding after a long day. The calming design and smooth animations make solving puzzles feel like a breeze rather than a chore.”
“I love tracking my solve times across difficulty levels. The clean interface keeps me focused, and the real-time validation saves me from frustrating mistakes.”
“Finally a Sudoku app that just works — no clutter, no ads, no distractions. The difficulty selection is spot-on and the wind animations are a lovely touch.”
Ready to Challenge Yourself?
Pick a difficulty, start a puzzle, and enjoy a calm, focused Sudoku experience. No distractions — just you and the breeze.
No comments yet. Be the first!