db.

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.

LiveAny modern browser; installable and offline-capable

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.

AreaCourses
LanguagesSpanish, French, German, Italian, Portuguese (Brazil), Polish, Latin, Greek (Koine and Classical), Japanese, Mandarin
Sciences and medicineBiology, general and organic chemistry, functional groups with structures and pKa, physics, engineering, anatomy and physiology, medical terminology, medicine
MathCalculus and generated mental math
MindLogic and critical thinking, philosophy, psychology, the arguments for God
ReadingThe Bible, the Great Books, the Ancients, advanced vocabulary
World and skillsWorld 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.

Terminal
npm test       # builds dist/ and runs content and version checks
npm run serve  # builds, then serves dist/ at http://localhost:8080

dist/play/ is the game and dist/index.html is the project site.

Release an update

  1. Change src/ (or site/ for the project page).
  2. Add an entry at the top of changelog.json with a higher version, a date and notes. That version is stamped into the game, service worker and site.
  3. Run npm test, commit and push to main. 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.