Skip to content

README.md

Latest commit

 

History

History
48 lines (36 loc) · 2.18 KB

README.md

File metadata and controls

48 lines (36 loc) · 2.18 KB
Raw

Word Blast - The Keyboard Warrior's Challenge

The Vision

Word Blast is a fast-paced browser game where your keyboard is your weapon. Words fall from the sky like missiles, and you must type them out to destroy them before they breach your defenses.

The Goal: Survive as long as possible, rack up a high score, and improve your typing speed!

Tech Stack

  • Core: HTML5 Canvas (Rendering)
  • Logic: Vanilla JavaScript (ES6+)
  • Styling: CSS3 (Cyberpunk/Hacker theme)
  • No Frameworks: Pure, dependency-free code for easy learning.

Project Structure

  • index.html: The main entry point containing the game canvas and UI overlay.
  • script.js: The game engine. Contains the game loop, enemy logic, and input handling.
  • style.css: Visual styling for the UI, scoreboards, and game container.
  • ISSUES.md: A list of suggested features and bugs for PatchFest participants.

How to Play

  1. Start the Game: Open index.html in your browser.
  2. Type to Shoot: Look at the falling words. Type the letters on your keyboard to destroy them.
  3. Don't Miss: If a word hits the bottom of the screen, it's GAME OVER.

How to Contribute (PatchFest)

We welcome contributions of all levels! Whether you want to fix a typo or build a boss battle system, there's a task for you.

  1. Pick an Issue: Check the Issues tab (or ISSUES.md). Look for labels like difficulty:easy, difficulty:medium, or difficulty:hard.
  2. Fork & Clone: Fork this repository and clone it to your local machine. 
    git clone https://github.com/YOUR-ORG/typing-defense.git
  3. Create a Branch: Always work on a new branch. 
    git checkout -b feature/add-sound-effects
  4. Code & Test: Open index.html in your browser (or use VS Code Live Server) to test your changes instantly.
  5. Submit PR: Push your changes and open a Pull Request!

Ideas for Contribution

  • Easy: Add new words to the dictionary, change colors, fix UI alignment.
  • Medium: Add sound effects, create a "Pause" button, implement a High Score system.
  • Hard: Add particle explosions, create a "Boss" enemy, add mobile support.