Ongoing

Puzzle Feed

Creator · 2026 · 2 min read

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

A Pyramid solitaire puzzle in the Puzzle Feed web app on desktop
Pyramid solitaire, one of the puzzles in the feed
A Binary puzzle in the Puzzle Feed app on a phone, with the bottom navigation bar
On a phone: scroll to the next puzzle

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

Reasoning:

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.

Alternatives considered:
  • Curated puzzle packs
  • A backend serving puzzles

No UI framework, shared game kits instead

Reasoning:

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 categories
    Games
  • 5 per game, with auto-levelling
    Difficulty 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.