# pomo-tui

> A beautiful terminal-based Pomodoro timer built with React Ink

[![NPM Version](https://img.shields.io/npm/v/pomo-tui.svg)](https://www.npmjs.com/package/pomo-tui)
[![Node Version](https://img.shields.io/node/v/pomo-tui.svg)](https://www.npmjs.com/package/pomo-tui)
[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

## Features

- Beautiful terminal UI with gradients and big text display
- Multiple timer modes:
  - Pomodoro Timer (25 minutes)
  - Short Break (5 minutes)
  - Long Break (15 minutes)
  - Custom Stopwatch
- Fullscreen support
- Keyboard shortcuts
- Minimal and focused

## Install

```bash
npm install -g pomo-tui
```

## Usage

```bash
# Start pomo-tui
pomo-tui

# Show help
pomo-tui --help
```

## Keyboard Shortcuts

- `space` - Start/Pause timer
- `r` - Reset timer
- `q` - Quit
- `f` - Toggle fullscreen
- `←/→` - Navigate between modes

## Built with

- [React](https://reactjs.org) - UI Library
- [Ink](https://github.com/vadimdemedes/ink) - React for CLIs
- [ink-big-text](https://github.com/sindresorhus/ink-big-text) - Big text component
- [ink-gradient](https://github.com/sindresorhus/ink-gradient) - Gradient text component

## License

MIT © [Shivaraj110](https://github.com/shivaraj110)