Skip to content

fizzexual/wiki-game

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

The Wiki Game

Connect two Wikipedia articles using only the links inside the page. Fewer clicks is better.

Telescope → Astronomy → Marathon

Run

pip install -r requirements.txt
cd frontend && npm install && npm run build && cd ..
python app.py

Open http://127.0.0.1:5000. Requires Python 3.10+ and Node 18+.

For frontend development with hot reload, run Flask and Vite side-by-side:

python app.py                       # backend on :5000
cd frontend && npm run dev          # frontend on :5173 (proxies /api and /play)

How it works

When a round starts, a bidirectional breadth-first search runs against the Wikipedia API in the background — forward from the start via prop=links, backward from the target via prop=linkshere, meeting in the middle. By the time you give up or solve the puzzle, the optimal path is already cached and revealed instantly.

The article you read is proxied through the server with internal links rewritten to stay inside the app, which lets the game count your clicks without injecting anything into Wikipedia.

Features

  • Random pairs from a curated, categorised topic list — no obscure stubs
  • Configurable challenge: categories, difficulty, time limit, click cap, no-back-button mode
  • Embedded browser-style view of proxied Wikipedia
  • Optimal-path reveal at game end (your clicks vs. shortest possible)
  • Recent attempts saved locally
  • Light / dark theme

Stack

Flask · React 18 + TypeScript + Vite · Wikipedia REST + Action APIs

About

The Wiki Game — race to connect two Wikipedia articles using only in-page links, with fewer clicks being better. Bidirectional BFS reveals the optimal path, plus configurable challenges (difficulty, time limits, click caps, no-back-button mode).

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors