Graze documentation
Graze documentation
Play Graze, choose courses, use lessons, recall gates, the Feed and spaced review, move progress between devices, and run or release your own build.
Play
Open Graze in a modern browser. It is installable and works offline after the first visit.
Choose what you learn
Open the Library and pick courses in the order you want. Your first course is your focus; the rest mix in. You set how many new items you get a day, from 5 to 30.
| Area | Courses |
|---|---|
| Languages | Spanish, French, German, Italian, Portuguese (Brazil), Polish, Latin, Greek (Koine and Classical), Japanese, Mandarin |
| Sciences and medicine | Biology, general and organic chemistry, functional groups with structures and pKa, physics, engineering, anatomy and physiology, medical terminology, medicine |
| Math | Calculus and generated mental math |
| Mind | Logic and critical thinking, philosophy, psychology, the arguments for God |
| Reading | The Bible, the Great Books, the Ancients, advanced vocabulary |
| World and skills | World geography with maps and flags, world history, the big ideas of Sapiens, grammar and style, research skills, strategy, martial arts, software engineering |
Learn, recall, review
- Lessons introduce eight new items at a time with examples, pictures and audio, then a quick check.
- Recall gates appear during the arcade run: a short recall-first pause, then two choices under light time pressure.
- Recall it first. Feed cards hide their choices until you have tried to answer from memory. Functional groups also come back in reverse: you see a name and pick the structure.
- The Feed (press F) is a vertical stream of due reviews, new items, speaking cards, quick math and readings.
- Spaced review moves each item through 10 minutes, then 1, 3, 7, 16, 35, 90 and 180 days.
- Speech reads every language item aloud and checks pronunciation where the browser supports speech recognition (Chrome, Edge and Safari).
Keep your progress
Progress is saved in the browser on your device. Transfer codes and backup files move it to another device and merge rather than overwrite.
Run it locally
Requires Node 18 or newer.
npm test # builds dist/ and runs content and version checks
npm run serve # builds, then serves dist/ at http://localhost:8080dist/play/ is the game and dist/index.html is the project site.
Release an update
- Change
src/(orsite/for the project page). - Add an entry at the top of
changelog.jsonwith a higher version, a date and notes. That version is stamped into the game, service worker and site. - Run
npm test, commit and push tomain. The Pages workflow builds, checks and deploys.
Players see an Update button within about half an hour. Save data carries a schema version; a change to its shape needs a migration in src/core.js.
Content sources
Courses are original wording checked against free sources, listed in each course's meta.json: OpenStax and LibreTexts textbooks, COERLL language courses, the Dickinson College Commentaries, Perseus, MedlinePlus, the Stanford and Internet Encyclopedias of Philosophy, and Project Gutenberg. Report a mistake by opening an issue. node scripts/check-course.mjs <key> validates a course.
Something unclear or out of date? Open an issue on GitHub.