kid-games

A small Zola site for kid-games.dev, with responsive game tiles and automatic light/dark styling based on the device preference. Alphabetical Adventure is the site's alphabetical-order game, Proofreading Detectives is its proofreading game, Number Trail is its woodland math adventure, Acorn Adventure introduces cumulative, multistep arithmetic, and Picnic Pizza introduces equal shares and visual fractions, while Ribbon Workshop explores fractions with equal-length ribbons, and Fraction Bridge helps children find, compare, and order fractions on a number line. Place-Value Builders visualizes hundreds, tens, ones, and regrouping. Math Meteor Patrol adds optional, gently timed arithmetic-fluency practice, and Clockwork Critters introduces reading and setting analog clocks.

Quiz mode

Add ?quiz=1 to the home page or any game URL to opt into quiz mode. The landing page's For grown-ups link opens a page with a quiz-mode toggle, the public GitHub repository, and MIT licensing and third-party attribution information. The toggle changes the URL setting, not a saved browser preference. Internal navigation keeps the flag; omit it (or use ?quiz=0) for normal play. Quiz mode removes worked examples, reference hints, and immediate grading. Next question, Previous question, and Review answers let players change any answer as often as they like before Submit quiz. The “Show your parent!” screen then gives a rounded percent correct and expandable Answer details, including incorrect responses and corrections.

Each completely correct question earns one point: an entire word order or proofreading passage, one Number Trail puzzle, one Acorn Adventure stop, one Picnic Pizza or Ribbon Workshop fraction question, one Fraction Bridge challenge, one Place-Value Builders question, or one Clockwork Critters time. Unanswered questions count as incorrect. Proofreading requires marking every mistake without marking correct text. Acorn Adventure uses a numeric input instead of answer choices and carries the player's entered totals, so later stops cannot reveal whether an earlier answer was right. Each stop is scored against the original journey; revising a total does not automatically rewrite later answers. Alphabetical quiz words use the selected theme and have keyboard- and touch-friendly Up/Down controls.

Quiz answers live only in memory: leaving or reloading discards them, and ordinary saved game progress is neither loaded nor changed. Ribbon Workshop quiz questions use the same level progression and score one point for each fully correct fraction response. Place-Value Builders quizzes ask about the same place-value representations and comparisons; answers can be revised before submission, and grading waits until then.

Community and license

Original project code and content are licensed under MIT. Bundled OpenDyslexic fonts and WordNet-derived data retain their separate licenses; see Third-party notices.

Contributions are welcome! Start with Contributing, meet the contributors, and follow our Code of Conduct. Report vulnerabilities privately as described in Security.

Local development

Install the latest Zola release and the latest Node.js LTS release supported by Playwright, then run these commands from the repository root:

zola serve

Open http://127.0.0.1:1111. To validate or generate the site:

zola check
zola build

Generated files go into public/ and are not committed.

Add a game

Each game has a directory under content/, containing an index.md. Set its title, description, weight (tile order), template, and icon. The root page lists these games automatically. Every game also needs at least 10 themed rewards (see Themed rewards). The alphabetical game uses templates/alphabetical-order.html and static/alphabetical-order.js; it loads the tagged word bank from static/words.json. Each new round randomly selects appropriate words for the current level; retries keep the same set in a new order.

The game is a 10-level quest that ramps from 4 words to 12:

Level	Words	What changes
1–3	4, 5, 6	Every word starts with a different letter
4–7	7, 8, 9, 10	One to four pairs share a first letter (look at the second letter)
8	11	Adds a pair sharing two letters (look at the third letter)
9	12	Two third-letter pairs and four second-letter pairs
10	12	Dinosaur challenge, with at least one pair sharing two letters

Themed rewards

Every game celebrates right answers (and its finale) with at least 10 rewards that match its theme, drawn at random by the shared celebration layer in static/alphabet-celebration.js. Each reward set also has themed cheers that prefix the success feedback.

This is the beginning of the README. Read the rest at the original. Read the full README ↗