https://github.com/hsztul/hackernews-pro
A Chrome extension that provides intuitive keyboard navigation and "save for later" functionality for HackerNews, with a minimal aesthetic.
https://github.com/hsztul/hackernews-pro
chrome extension
Last synced: about 2 months ago
JSON representation
A Chrome extension that provides intuitive keyboard navigation and "save for later" functionality for HackerNews, with a minimal aesthetic.
- Host: GitHub
- URL: https://github.com/hsztul/hackernews-pro
- Owner: hsztul
- Created: 2025-05-30T18:20:08.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-18T11:39:08.000Z (9 months ago)
- Last Synced: 2026-04-30T06:32:33.992Z (about 2 months ago)
- Topics: chrome, extension
- Language: JavaScript
- Homepage:
- Size: 75.2 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# HackerNews Pro (hpro)
A Chrome extension that provides intuitive keyboard navigation and "save for later" functionality for HackerNews
## Features
### 🎯 Target Pages
- HackerNews front page (`news.ycombinator.com/`)
- Newest stories (`news.ycombinator.com/newest`)
- Past stories (`news.ycombinator.com/past`)
- All paginated pages (e.g., `?p=2`, `?p=3`, etc.)
### ⌨️ Keyboard Navigation
#### Story Navigation
- **↑/↓ Arrow Keys** or **j/k**: Navigate between story entries
- **Enter**: Open selected story in current tab
- **Shift + Enter**: Open selected story's comments in a new tab
- **o**: Open selected story in current tab
- **Shift + O**: Open selected story in new tab
- **m**: Go to next page (follows "More" link)
- **Shift + S**: Save current story for later
- **Escape**: Temporarily clear highlight (resume with any navigation key)
- **Command/Ctrl + K**: Open saved entries modal
#### Modal Navigation
- **↑/↓ Arrow Keys** or **j/k**: Navigate through saved entries
- **Enter**: Open selected entry in new tab
- **Delete/Backspace**: Remove entry (with confirmation)
- **Escape**: Close modal or cancel deletion
### 💾 Save for Later
- Local storage for saved entries (URL + title + HN link + timestamp)
- Beautiful in-page modal interface for managing saved stories
- Visual feedback when saving stories ("Saved for later!" notification)
- Duplicate detection (prevents saving the same story twice)
- Delete entries with confirmation dialog
- Comprehensive keyboard shortcuts guide in modal
### 🎨 Design
- Minimal, clean aesthetic inspired by Raycast and Arc
- Subtle selection outlines that don't interfere with HN's design
- Smooth animations and transitions
- Professional typography and spacing
- Keyboard shortcuts guide integrated into modal
### 🔄 Smart Page Handling
- Automatic reinitialization when navigating between HN pages
- Works seamlessly with "more" button and pagination
- Maintains functionality across all HackerNews navigation patterns
- Preserves modal state and keyboard shortcuts
## Installation
### From Source (Development)
1. Clone or download this repository
2. Open Chrome and navigate to `chrome://extensions/`
3. Enable "Developer mode" in the top right
4. Click "Load unpacked" and select the extension folder
5. The extension will now be active on HackerNews pages
### Usage
1. Navigate to any supported HackerNews page
2. Use **j/k** or arrow keys to navigate between stories
3. Use **Enter** to open stories in the current tab
4. Use **Shift+Enter** to open the comments page in a new tab
5. Use **o** or **Shift+O** to open stories (current tab / new tab)
6. Use **Shift+S** to save stories for later
7. Press **Command/Ctrl + K** to view and manage your saved stories
## Keyboard Shortcuts Summary
| Shortcut | Action |
|----------|--------|
| `↑`/`↓` or `j`/`k` | Navigate stories |
| `Enter` | Open story in current tab |
| `Shift + Enter` | Open comments in new tab |
| `o` | Open selected story in current tab |
| `Shift + O` | Open selected story in new tab |
| `m` | Go to next page (follows "More" link) |
| `Shift + S` | Save story for later |
| `⌘/Ctrl + K` | Open saved entries modal |
### In Modal
| Shortcut | Action |
|----------|--------|
| `↑`/`↓` or `j`/`k` | Navigate saved entries |
| `Enter` | Open entry |
| `Delete`/`Backspace` | Remove entry |
| `Esc` | Close modal |
## File Structure
```
hacker-news-extension/
├── manifest.json # Extension configuration
├── content_script.js # Main navigation and modal logic
├── styles.css # Visual styling
├── background.js # Service worker
└── README.md # This file
```
## Technical Details
- **Manifest Version**: 3
- **Permissions**: `storage` (for saving entries locally)
- **Target Sites**: `*://news.ycombinator.com/*`
- **Storage**: Chrome local storage for saved entries
- **Architecture**: Content script with automatic page change detection
## Browser Compatibility
- Chrome (Manifest V3)
- Other Chromium-based browsers (Edge, Brave, etc.)
## Contributing
Feel free to submit issues and feature requests!