NewbieGame CLI

From an empty folder to a running web game in less than two minutes.

NewbieGame CLI is a beginner-friendly developer tool designed for teen hackers and game jam participants. It scaffolds fully functional 2D web games (HTML5 Canvas + JavaScript) with zero build tools or complex setup required.

Quick Start

1. Run via npx

npx newbiegame create

Or supply flags directly:

npx newbiegame create my-dino-game --template topdown

2. Run your game

cd my-dino-game
npx newbiegame serve

Your browser will automatically open http://localhost:8000 with your game running live!

Included Templates

| Template | Description | Features | |---|---|---| | topdown | 2D Top-down Adventure | Player movement (WASD/Arrows), particle physics, live developer inspector, audio effects. | | platformer | 2D Platformer Game | Gravity physics, jump mechanics, platforms, collectibles. | | cards | Card Battle Engine | Interactive card hand, 3D tilt effect, turn logic, score tracking. | | blank | Minimal Canvas Starter | Game Loop, Input handler, Canvas renderer ready for custom code. |

CLI Commands

• newbiegame create [NAME]: Create a new web game project.
• newbiegame serve: Start a local HTTP server and open the browser.
• newbiegame add [COMPONENT]: Inject reusable components (score, keyboard, collision, audio).
• newbiegame doctor: Check project structure and fix common errors.
• newbiegame templates: List all available game starters.

Educational Philosophy

Every generated project includes:

• GUIDE.md: Step-by-step instructions on how to change colors, speed, sprites, and add mechanics.
• A built-in Live Developer Inspector panel inside games for testing variables in real time.
• Clean, explanatory comments in code written by developers for developers.

Built for Hack Club Anvil

Created for the Hack Club Anvil YSWS.