Skip to content

weiran/Hackers

Repository files navigation

Hackers

Swift 6.2 CI License: MIT

Hackers is an open-source Hacker News client for iPhone and iPad.

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

Hackers screenshot

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.

Requirements

  • iOS/iPadOS 26 or later
  • Xcode 26.4 for development
  • Swift 6.2

The app also runs on Apple Silicon Macs and visionOS through Apple's platform compatibility support.

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

The maintained docs are intentionally small:

Contributing

Issues and pull requests are welcome. Before opening a PR:

  • Run ./run_tests.sh.
  • Keep changes scoped.
  • Add or update tests for behavior changes.
  • Follow the existing SwiftUI, Swift Testing, and package patterns.

Privacy

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

License

Hackers is released under the MIT License.

About

Hackers is an elegant iOS app for reading Hacker News written in Swift.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors