Hackers

Hackers is an open-source Hacker News client for iPhone and iPad, built with SwiftUI.

It focuses on fast feed browsing, readable comment threads, voting, bookmarks, search, Dynamic Type, VoiceOver, dark mode, and a native iOS/iPadOS experience. Version 5 is a SwiftUI rebuild with a modular Swift Package layout.

Download on the App Store
Join the TestFlight beta

Features

• Browse Top, New, Best, Ask, Show, Jobs, and Active stories.
• Read nested comments with collapse/expand controls.
• Open stories in the in-app browser with comments available alongside the page.
• Vote on posts and comments when signed in.
• Save bookmarks and search Hacker News content.
• Use the share extension to open Hacker News links in Hackers.
• Supports Dynamic Type, VoiceOver, dark mode, and high-contrast-friendly styling.
• No ads, no tracking, no analytics.

The repository currently targets iOS and iPadOS. Apple Silicon Mac compatibility may be available through Apple's platform support, but iOS/iPadOS are the platforms covered by the project's build and CI configuration.

Requirements

• macOS
• Xcode 27.0 (see .github/xcode-version)
• iOS 26 or later Simulator runtime
• Swift 6.4

Build

Open Hackers.xcodeproj in Xcode and run the Hackers scheme.

Command-line build from the repository root:

xcodebuild -project Hackers.xcodeproj -scheme Hackers -destination 'platform=iOS Simulator,name=iPhone 17 Pro' build

Test

Use the project test runner:

./run_tests.sh

Run a specific module:

./run_tests.sh Domain
./run_tests.sh Feed Comments Settings

Do not use swift test for project validation; the packages target iOS APIs and need an iOS Simulator destination.

Documentation

Start with the contributor documentation:

• Project overview
• Development guide
• Release process
• Documentation index
• Contributing
• Security policy
• Support

Contributing

Issues and pull requests are welcome. Please read CONTRIBUTING.md before starting work. In particular:

• Search existing issues and pull requests before opening a new one.
• Explain the problem and proposed solution before investing in a large change.
• Run the relevant checks and report what you ran in the pull request.
• Add or update tests for behavior changes.

For a quick local check, run:

./run_tests.sh
./run_ui_tests.sh smoke

Privacy

Hackers collects no data. The App Store privacy label is Data Not Collected.

License

Hackers is released under the MIT License.