newbiegame 0.1.0

Create beginner-friendly web games from your terminal in under two minutes.

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.