tui-crawler/README.md

A terminal-based dungeon crawler game with ASCII graphics

# TUI Crawler

A terminal-based dungeon crawler game with ASCII graphics built with OpenTUI.

## Quick Start

```bash
bunx tui-crawler
```

Or install globally:

```bash
npm install -g tui-crawler
tui-crawler
```

## Controls

- **WASD** or **Arrow Keys**: Move player
- **Ctrl+C**: Exit game

## Requirements

- Node.js 18+ or Bun runtime
- Terminal with true color support
- Minimum terminal size: 80x24

## Features

- Procedurally generated dungeon levels
- Smooth sub-tile movement
- ASCII art graphics
- Health and mana system
- Real-time gameplay

## Development

```bash
# Clone the repository
git clone https://github.com/yourusername/tui-crawler.git
cd tui-crawler

# Install dependencies
bun install

# Build the project
bun run build

# Run locally
bun run crawl
```

## License

UNLICENSED