Puzzle Feed
An endless feed of puzzles so you can doomscroll something more productive. Ad-free, open source, local-first, and with 53 procedurally generated puzzles for an endless feed of fun!
Overview
Puzzle Feed is an endless feed of short puzzles you scroll through like a social feed: Sudoku, Nonograms, Bridges, FreeCell, mate-in-two chess, word games and more. Puzzles are procedurally generated from a seed, so they can be shared and replayed, and a shared daily seed gives everyone the same list of puzzles each day, for a social aspect.
Screenshots
Problem
We spend too much time on brain-rotting endless feeds: YouTube Shorts, Instagram Reels, Twitter and the like. I wanted a feed that could be a healthier addiction, one that makes you use your brain while doomscrolling, and that isn't driven by profit, so it can't be enshittified.
Constraints
- Static site only: no server, no accounts; profile, stats and unfinished games live in localStorage
- Every game generated on the fly from a seed, fast enough to keep the feed instant
- Fully playable offline and installable on mobile
- Bilingual (English and Québec French), including the word games' dictionaries
Approach
A plain TypeScript app built with Vite, one file per game, auto-registered into the feed. Shared engines (sudokukit, logickit, pathkit, movekit, cardkit, chesskit, wordkit) carry most of the logic, so a new game is mostly its rules and its generator. Each game has five difficulty levels and the feed auto-levels based on how you do.
Key Decisions
Seeded generation instead of puzzle packs
A seed is a whole puzzle: it gives an infinite feed, a shared daily puzzle and shareable links without storing or serving any puzzle data.
- Curated puzzle packs
- A backend serving puzzles
No UI framework, shared game kits instead
The games are mostly grid rendering with their own input handling. Small shared kits per family of games gave more reuse than a component framework would, and kept the bundle small for offline use.
Tech Stack
- TypeScript
- Vite
- PWA (vite-plugin-pwa)
- Vitest
- Playwright
- oxlint & oxfmt
- GitHub Pages
Result & Impact
- 53, in 7 categoriesGames
- 5 per game, with auto-levellingDifficulty levels
A free, ad-free puzzle feed that works offline on any device, with a daily set and shareable puzzles.
Learnings
- Writing generators that guarantee a unique solution is the hard part of most logic puzzles; the UI is the easy part.
- Automated screenshot runs of every game at every level catch layout regressions that unit tests never would.