phtui

command module
v0.0.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 21, 2026 License: MIT Imports: 5 Imported by: 0

README

phtui

Product Hunt TUI - browse the Product Hunt leaderboard from your terminal.

Go

Features

  • Browse Daily / Weekly / Monthly leaderboards
  • Browse by category (248 categories with search/filter)
  • Clickable date navigation bar (mouse support)
  • Product detail view with ratings, reviews, pros/cons, pricing, and links
  • Open products in your browser with o
  • Vim-style keyboard navigation
  • Dracula color theme (16-color ANSI)
  • In-memory caching for fast navigation

Install

Homebrew
brew install qyinm/tap/phtui
Go
go install github.com/qyinm/phtui@latest
Build from source
git clone https://github.com/qyinm/phtui.git
cd phtui
go build -o phtui .
./phtui

Usage

phtui
Key Bindings
Key Action
j / k Navigate up/down
Enter View product detail
Esc Back to list
Tab Cycle period (Daily/Weekly/Monthly/Categories)
1 2 3 4 Switch to Daily/Weekly/Monthly/Categories
h / l Previous/next date (or category)
/ Search (global product search, or filter categories)
o Open in browser
r Refresh
? Toggle help
q Quit

Mouse clicks are supported on the period tabs and date bar. Use / to open search input, type a query, then press Enter to run global search. Press 4 or Tab to open the category selector, browse with j/k, and press Enter to view products. Use / to filter categories by name.

Architecture

types/          Core types (Product, ProductDetail, ProductSource interface)
scraper/        HTTP scraper + HTML/SSR parser + cache
ui/             Bubbletea TUI (model, styles, keys, commands, delegate)
main.go         Entry point

Built with Bubbletea, Bubbles, Lipgloss, and goquery.

License

MIT

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL