Metadata-Version: 2.4
Name: newbiegame
Version: 0.1.0
Summary: Create beginner-friendly web games from your terminal in under two minutes.
Project-URL: Homepage, https://anvil.hackclub.com
Project-URL: Repository, https://github.com/mitosky07/newbiegame
Project-URL: Issues, https://github.com/mitosky07/newbiegame/issues
Author-email: NewbieGame Team <hackers@hackclub.com>
License: MIT
License-File: LICENSE
Keywords: beginner,canvas,cli,education,gamedev,hackclub,javascript
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.10
Requires-Dist: jinja2>=3.1.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.12.0
Provides-Extra: dev
Requires-Dist: build>=1.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: twine>=4.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# NewbieGame CLI

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

[![PyPI Version](https://img.shields.io/pypi/v/newbiegame.svg)](https://pypi.org/project/newbiegame/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Hack Club Anvil](https://img.shields.io/badge/Hack%20Club-Anvil%20YSWS-red)](https://anvil.hackclub.com)

**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`

```bash
npx newbiegame create
```

Or supply flags directly:

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

### 2. Run your game

```bash
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**.
