# Introduction

Nova2D is a **base framework for Love2D** that standardizes project structure, dependency management, and development tooling for 2D games in Lua.

It provides a ready-to-run skeleton with 5 game states, a built-in package manager, and a clean conventions layer so you can focus on building your game instead of wiring up infrastructure.

## Philosophy

- **Structure over chaos**: predefined directories and naming conventions keep your project organized from day one.
- **Tooling built-in**: dependency manager, hot reload, and debug tools are included — no hunting for libraries.
- **Love2D native**: pure Lua 5.1, no external runtimes, no build steps. What you write is what runs.

## What you get

| Feature | Status |
|---|---|
| 5 game states (splash, menu, game, pause, credits) | v0.1 |
| Dependency manager with lockfile | v0.2 |
| Hot reload | v0.3 |
| One-command installer | v0.4 |
| Web documentation | v0.5 (live at [nova2d.pages.dev](https://nova2d.pages.dev/)) |
| Core Systems (jump, health, timer, camera, input) | v0.6 |