Skip to content

mclaughj23/ged-math-practice

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

GED Mathematical Reasoning Practice Test

A free, self-contained web application for GED Math preparation — no installation, no server, no account required.

Developed for: Plainfield Public Library Adult Literacy Program Last updated: February 2026


How Students Use This

Option 1 — GitHub Pages (Recommended for Zoom class)

Share this URL with students: https://[your-username].github.io/[repo-name]/

Students open the link in any browser — phone, tablet, or computer. No download needed.

Option 2 — Download & Open Locally

  1. Click the green Code button → Download ZIP
  2. Extract the ZIP
  3. Open index.html in any web browser (Chrome, Firefox, Edge, Safari)
  4. No internet required after download

What's on the Test

Details
Questions 46 total (matches official GED format)
Part 1 Questions 1–5 · No calculator
Part 2 Questions 6–46 · Calculator allowed
Time Limit 115 minutes with visible countdown
Topics Percent, Algebra, Geometry, Statistics, Probability, and more

Two-Stage Learning System

Every question has two stages:

  • Stage 1 — Foundation Step: A guided warm-up question that teaches the key concept or formula needed. Get immediate feedback here.
  • Stage 2 — Main Question: The actual GED-style question. This is what counts toward your score.

This scaffold approach ensures students understand how to solve the problem before tackling the full question.


GED Math Topics Covered

Quantitative Problem Solving (~45%)

  • Number operations and number sense
  • Ratios, proportions, and percentages
  • Data analysis and statistics
  • Measurement and unit conversions
  • Geometric measurement

Algebraic Problem Solving (~55%)

  • Linear equations and inequalities
  • Systems of equations
  • Quadratic relationships
  • Graphing and functions
  • Exponents and radicals

Student Features

  • Name registration — personalize your test experience
  • Timer — 115-minute countdown with color warnings
  • Flag for review — mark questions to revisit
  • Question navigator — jump to any question
  • Formula sheet — accessible during the test (Part 2)
  • Calculator reference — TI-30XS guide accessible during Part 2
  • Auto-save — progress saved every 30 seconds (browser localStorage)
  • Resume test — return to an in-progress test after closing the browser
  • Results page — score with topic-by-topic breakdown
  • Answer review — see correct answers, your answers, and full explanations

Score Interpretation

Score Percentage GED Status
30–46 65–100% Passing range
20–29 43–63% Below passing — keep practicing
Below 20 Under 43% Foundational review needed

Note: The actual GED Mathematical Reasoning test uses a scaled score (100–200), with 145 as the passing score. This practice test gives a percentage equivalent to guide your preparation.


For Instructors

Setting Up GitHub Pages

  1. Fork or push this repository to your GitHub account
  2. Go to Settings → Pages
  3. Set Source to main branch, root folder
  4. GitHub will provide a URL like https://username.github.io/repo-name/
  5. Share that URL with your students

Email Score Reports (Optional)

The test can automatically email you students' scores when they finish. To enable:

  1. Open index.html in a text editor
  2. Find this line near the top of the JavaScript:
    const FORMSUBMIT_EMAIL = 'your.email@example.com';
  3. Replace with your actual email address
  4. The first submission will send a confirmation email — approve it once

What You'll Receive Per Student

  • Student name and email (if provided)
  • Final score (X/46 and percentage)
  • Time taken
  • Topic-by-topic breakdown

Technical Details

  • Single file — everything in index.html (HTML + CSS + JavaScript)
  • No dependencies — KaTeX math library loads from CDN (internet required for math rendering; falls back gracefully)
  • No backend — all logic runs in the browser
  • No tracking — student data stays in their browser (localStorage) unless email reporting is configured
  • Works offline — after first load, test functions without internet (math symbols may not render without internet)
  • Mobile-friendly — responsive design works on phones and tablets

License

Free to use, adapt, and share for educational purposes.


Built with Claude Code · Plainfield Public Library Adult Literacy Program · 2026

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages