📚 Study Tools Platform
A free, open-source study tool for students — flashcards, quizzes, games, and more.
Built for GitHub Pages. Powered by a single config file. No coding required to customize.
Are you a teacher? Fork this repo and make it your own — any subject, any grade level.
👉 Teacher Setup Guide — step-by-step instructions, no coding experience needed.
✨ What Students Get
📖 Study
| Activity | Description |
|---|
| Learn Mode | Guided study sessions inspired by Seneca Learning. Short interactive slides with adaptive depth (3 tiers), an ungraded warm-up and a closing check, reflection prompts tied to a term the student just got right, Wiki Writer bonus challenge, 1.5x points multiplier |
| Textbook | Interactive reading with 4 reading levels (Quick/Clear/Full/Deep), collapsible sidebar navigation, vocab highlighting, key terms with tap-for-a-note, an optional Word colors switch that colors each section's new words by part of speech (noun, verb, adjective, adverb), pronunciation guides beside hard words at Quick and Clear, section pictures that open large when clicked, Primary Source quote boxes with a portrait, a plain-words line at Quick and Clear and a link to the source, Key Idea callouts, Quick Checks, an optional written question under a reading that goes to the teacher, optional Read More panels with the longer version of a section and a Read More Check that sends a written answer to the teacher, reading progress tracking, a highlighter with a "My highlights" list in the sidebar, and "Keep going" links at the end of each chapter |
| Flashcards | Anki-style spaced repetition with 3D flip animation, confidence rating, "Make Your Own Example", vocab tiers (must-know/encounter/bonus), and "Read in textbook" deep-links |
| Short Answer | Visual card-based question selector with topic images, color-coded categories, and key term chips. Answers save as the student types; Save Response sends a signed-in student's answer to the teacher, and an answer of 20+ words earns 20 study points once per question. Paste is blocked |
| Source Analysis | Primary source analysis using the SIFT method with scoring |
| Typing Practice | Monkeytype-inspired typing with full passages and per-term snippets; works with phone keyboards |
| Resource Library | Searchable vocabulary reference with mastery indicators, Simple Wikipedia and Wikipedia links, and teacher-curated "Go deeper" links (videos, challenge readings, reference articles) per category |
| How to Study | Interactive study strategies page with comprehension quiz and Study Smart badge |
📝 Practice
| Activity | Description |
|---|
| Practice Test | 10-question mastery loop — tracks progress across sessions until every question answered correctly; wrong answers feed back to flashcards. Questions can be tagged core or extra: extras unlock once the core questions are answered right |
| Fill-in-the-Blank | One-at-a-time stepper with word bank or type-it mode |
| Timeline | Drag events into chronological order with shuffle, remove, and challenge mode |
| Power Sort | Tap each power into its branch or level of government (Legislative / Executive / Judicial, National / State / Both); untimed, explains every answer, replays missed items (1.25x analysis tier) |
🎮 Games
| Activity | Description |
|---|
| Sort It Out | Sort terms into category buckets with streak bonuses and speed timer (1.25x analysis tier) |
| Who Am I? | Guess the term from progressive clues — fewer clues = more points (1.25x analysis tier). Challenge mode: type the answer, every unit term in play, 1.5x points |
| Four Corners | Find the odd one out — 3 terms share a category, 1 does not belong (1.25x analysis tier) |
| Map Quiz | Click-on-the-map geography quiz with 3-strike hint system. Includes 1861 States & Territories map with Learn/Quiz modes and Union/Confederate/Border/Territory color-coding |
| Lightning Round | 60-second speed quiz with leaderboard |
| Crossword | Auto-generated crossword from vocabulary |
| Quiz Race | Timed 1v1 same-screen quiz race with leaderboard |
| Wordle | Guess the vocabulary term in 6 tries with definition clues |
| Tower Defense | 3D tower defense — answer vocab to earn coins, build towers, survive 10 waves |
| Flip Match | Memory matching — pair terms to definitions |
| Hangman | Classic word guessing with definitions |
| Term Catcher | Catch the falling correct term |
🧠 Smart Learning
- Cross-activity weakness tracking — wrong answers feed a shared tracker that surfaces weak terms across Flashcards, Practice Test, Fill-in-the-Blank, Lightning Round, and Typing Practice
- Auto study time tracking — time in activities counts automatically; pauses on inactivity or hidden tab
- Mastery gating — Read > Study > Practice > Play flow: students read the textbook chapter before flashcards unlock, then master terms to unlock games. Vocabulary tiers (must-know/encounter/bonus) focus study on tested terms
- Scheduled unlocks — Optional per-unit
categorySchedule opens categories on a calendar (e.g. one per week) so students who fall behind never get fully shut out. Mastery still accelerates ahead of the schedule
- Achievement system — unlockable badges with confetti for milestones
- Guest mode — parents and visitors can browse without entering a name
This is the beginning of the README. Read the rest at the original. Read the full README ↗
