# Tipoff - NBA Terminal Viewer

[![npm version](https://img.shields.io/npm/v/nba-tipoff.svg)](https://www.npmjs.com/package/nba-tipoff)
[![npm downloads](https://img.shields.io/npm/dm/nba-tipoff.svg)](https://www.npmjs.com/package/nba-tipoff)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Follow live NBA games directly in your terminal!

![screenshot](./demo.gif)

## Why?

A quick, discreet way to follow live NBA games or follow up on missed matchups from the night before.

Inspired by [playball](https://github.com/paaatrick/playball/tree/main)

## Quick Start

```bash
npx nba-tipoff
```

## Installation

```bash
npm install -g nba-tipoff
```

## Development

### Setup

```bash
# Clone the repository
git clone https://github.com/rfwilliams11/tipoff.git
cd tipoff

# Install dependencies
npm install

# Link the package locally for testing the CLI
npm link
```

### Running the Application

```bash
# Run in development mode
npm run dev

# Or use the CLI command (if linked)
nba-tipoff
```

### Testing

```bash
# Run tests
npm test

# Run tests with coverage
npm run test:coverage
```

## Features

- View today's NBA games in terminal
- Navigate between different dates
- View detailed game information with live updates
- Real-time statistics and play-by-play
- Keyboard navigation and shortcuts

## Keyboard Controls

### Scoreboard View

- `↑`/`↓` or `j`/`k` - Navigate between games
- `Enter` - View detailed game information
- `n` - Next day
- `p` - Previous day
- `t` - Go to today
- `q` or `Esc` - Quit

### Game Detail View

- `c` - Return to scoreboard
- `q` or `Esc` - Quit

## License

MIT