sumwords

Sumwords_Logo

Sumwords

Release License Open Source Tech GitHub Pages

“Know the Facts, Do the Math”

A constraint-based math puzzle game that combines trivia knowledge with equation solving. Answer trivia questions by placing numbers from a limited pool into mathematical equations while satisfying column sum constraints.

Landing Page: 🏠 Home of Sumwords

🎮 Play Now

Sumwords: 🎲 Play Game

Sumwords_in_Action
Sumwords in action

✨ Features

Core Gameplay

Categories

  1. Sports
  2. History
  3. Geography
  4. Pop Culture
  5. Science
  6. Movies & TV
  7. Food & Drink
  8. Technology
  9. Games & Literature
  10. Animals & Nature

Plus an “Everything” category that combines all questions for maximum variety.

Game Features

Visual Polish

🎯 How to Play

Goal

Place numbers from the number pool into the equation blanks to make valid equations. The sum of each column must match the target shown at the bottom.

Rules

  1. Answer the trivia question to learn which number is the solution
  2. Place numbers from the pool into equation blanks by clicking the pool number, then clicking a blank
  3. Select operators (Medium/Hard) from dropdowns between operands
  4. Satisfy constraints:
    • Each equation must be mathematically correct
    • Column totals must match the targets at the bottom
  5. Submit when all blanks are filled to check your solution

Tips

🛠️ Technology Stack

📦 Installation (Local Development)

  1. Clone the repository
   git clone https://github.com/TheBIMsider/sumwords.git
   cd sumwords
  1. Open in browser
   # Simply open index.html in your web browser
   # No build process or dependencies required
  1. Optional: Use a local server
   # Python 3
   python -m http.server 8000

   # Python 2
   python -m SimpleHTTPServer 8000

   # Node.js (if you have http-server installed)
   npx http-server

Then navigate to http://localhost:8000

📁 Project Structure

sumwords/
├── V01/
│   ├── index.html          # Game HTML structure
│   ├── styles.css          # Game styling with dark mode
│   ├── game.js             # Game logic and 500 trivia questions
│   └── Sumwords_Logo.png   # Game logo
├── landing/
│   ├── index.html          # Landing page HTML
│   ├── styles.css          # Landing page styling with dark mode
│   └── script.js           # Landing page theme switcher
├── README.md               # This file
└── LICENSE                 # BSD 3-Clause License

🎲 Game Design

Puzzle Generation

Difficulty Scaling

📊 Statistics

The game tracks comprehensive statistics including:

🤝 Contributing

Contributions are welcome! This is a personal learning project, but feel free to:

Adding Trivia Questions

Questions are stored in game.js in the triviaQuestions object. Each question needs:

Example:

{
  question: "How many keys are on a standard piano?",
  answer: 88,
  category: "Music & Arts"
}

📄 License

This project is licensed under the BSD 3-Clause License - see the LICENSE file for details.

👤 Author (Vibe Coder)

Carl Storms (The BIMsider) With the help of his AI Buddy 🤖 Claude AI: Sonnet 4.5

🙏 Acknowledgments

📝 Development

This project was developed (Vibe Coded) over 20 documented sessions with comprehensive planning:

🚀 Roadmap

Completed ✅

Potential Future Enhancements

Enjoy playing Sumwords! 🎮🧮

If you find a bug or have suggestions, please open an issue on GitHub.

This site is open source. Improve this page.