Synonym Sprint

Apps By James · Free educational vocabulary game

Play now: https://appsbyjames.github.io/synonymsprint/

An educational word game: you’re given a correctly spelled target word, and you fill synonym letter blanks (jumble-style underscores) for maximum score. The skill is expanding vocabulary, not unscrambling letters.

Keywords & topics

synonym game · vocabulary game · free word game · educational game · learn synonyms · English vocabulary · ESL · word jumble · SAT vocabulary · GRE vocabulary · kids learning games · language learning · browser game · no install

Suggested GitHub repository topics (Settings → Topics, or the gear on the About box):

vocabulary synonyms word-game educational-game javascript html5 css github-pages esl language-learning kids-education browser-game static-site apps-by-james

Play online (GitHub Pages)

Live game	appsbyjames.github.io/synonymsprint
Source	github.com/appsbyjames/synonymsprint
Creator	github.com/appsbyjames

No install, no account, no build step. Works in modern browsers on desktop and mobile.

Play locally

python server.py

Opens http://127.0.0.1:8000/. Options:

python server.py -p 8080          # custom port
python server.py --no-browser     # serve only
python server.py --host 0.0.0.0   # LAN access

Or open index.html directly. Stdlib Python only for the optional server — no pip install.

How to play

1. Choose Easy, Medium, or Hard.
2. Read the target word (already spelled).
3. The board shows every synonym as letter blanks (_ = one letter).
4. Type synonyms that fit a blank; score points for each hit.
5. Skip anytime (button or Ctrl+Arrow). After a round, study answers on the board; Next Round → / Enter continues.
6. Use ← → beside the round counter to review past words.
7. Clear a full board for a completion bonus. 20 rounds, one overall timer.

Difficulty	Focus	Hints	Time	Points / hit	Full-board bonus
Easy	Everyday words + richer synonyms	Yes	10:00	10	25
Medium	Academic / workplace vocabulary	Yes	10:00	15	40
Hard	Advanced reading vocabulary	No	10:00	20	60

High scores: localStorage key synonym-sprint-highscores. Theme: synonym-sprint-theme.

Deploy to GitHub Pages

This repo is ready for free GitHub Pages hosting.

One-time setup

1. Push this project to github.com/appsbyjames/synonymsprint.

2. Repo Settings → Pages → Build and deployment:

   • Source: GitHub Actions
     (workflow: .github/workflows/deploy-pages.yml)

3. After the first successful workflow run, the site is live at:

   https://appsbyjames.github.io/synonymsprint/

Alternative (branch deploy)

Settings → Pages → Source: Deploy from a branch → main / / (root).
Keep .nojekyll so Jekyll does not filter static assets.

What gets published

File	Purpose
index.html	App shell + SEO / Open Graph / JSON-LD
app.js	Game logic
words.js	Word banks
styles.css	Themes & layout
favicon.ico	Browser tab icon
synonymsprint.jpg	Logo / social preview / touch icon
site.webmanifest	Installable web app metadata
robots.txt / sitemap.xml	Crawler discovery
404.html	Friendly redirect home

Project layout

synonymsprint/
  index.html              # UI + meta / structured data
  app.js                  # game state + controls
  words.js                # WORD_BANK + DIFFICULTY
  styles.css              # light / dark themes
  favicon.ico
  synonymsprint.jpg       # brand logo
  site.webmanifest
  robots.txt
  sitemap.xml
  404.html
  server.py               # optional local static server
  .nojekyll               # GitHub Pages: serve files as-is
  .github/workflows/      # Pages deploy workflow
  README.md

• Data: WORD_BANK / DIFFICULTY in words.js
• Logic: single state object in app.js
• UI: three screens via CSS .active (no framework)

Extend play by appending entries to WORD_BANK.easy|medium|hard in words.js.

Browser support

Modern evergreen browsers (ES2019+). Playable offline after the first load of the static files.

License & credit

© Apps By James. All rights reserved.

Synonym Sprint is proprietary. You may play the free online game and use a private local copy for personal learning. You may not copy, modify, redistribute, rebrand, rehost, or commercialize the code, word banks, branding, or assets without prior written permission.

See LICENSE for the full notice.

This project is not released under MIT, Apache, GPL, BSD, or any other open-source license. Ownership and future monetization rights remain with Apps By James.

Made by Apps By James.
Repository: appsbyjames/synonymsprint · Play: appsbyjames.github.io/synonymsprint