• Every feed — Top, New, Best, Ask HN, Show HN, and Jobs, switchable from a pinned filter bar.
• Native comment threads — Hacker News comment HTML is parsed into native text with tappable links, italics, block quotes, and code blocks. Threads are collapsible with depth indicators, and the whole tree loads in a single request.
• Smart onboarding — a short first-run flow that reads your device's appearance and accessibility settings, pre-configures the app to match, and shows a live preview as you choose a theme, accent, and home feed.
• Search — full-text search across Hacker News by relevance or recency.
• Saved for later — bookmark any story; saved stories are stored on device and work offline.
• Read tracking — visited stories are dimmed so you can pick up where you left off.
• In-app reading — open links in an in-app Safari view with optional Reader mode, or hand off to your default browser.
• Profiles — view any user's karma, join date, about, and recent submissions.
• Thoughtful design — a warm, hand-tuned color system, full light/dark support, six accent themes, haptics, and fluid animations.

Accessibility is a first-class part of Ember, with particular care for color vision.

• Never color alone. Status is always carried by an icon, shape, or text in addition to color — points and comment counts pair an SF Symbol with their value, read state shows a checkmark, and selection states use rings and checkmarks.
• Color-blind friendly cues. A dedicated setting (auto-enabled when the system "Differentiate Without Color" is on) adds explicit non-color indicators throughout.
• VoiceOver. Story rows, comments, and controls expose meaningful labels, hints, traits, and custom actions; each story reads as a single coherent element.
• Dynamic Type. Typography scales with the system text size, and layouts — including comment indentation — adapt at accessibility sizes.
• Reduce Motion. Animations and the loading shimmer are minimized when Reduce Motion is enabled.
• Underlined links. Links in comments can be underlined so they remain identifiable without relying on color.
• The onboarding adapts. On first launch Ember detects VoiceOver, Reduce Motion, Differentiate Without Color, Bold Text, and large text, turns on the matching options, and tells you exactly what it changed.

Sources/
  App/              App entry, root tab view, environment wiring, in-app Safari
  Models/           HNItem, HNUser, Feed, Algolia models
  Networking/       HNService protocol, live client, mock for previews
  Stores/           Settings, bookmarks, read state
  DesignSystem/     Theme, typography, haptics, reusable components
  Utilities/        HTML comment renderer, relative time
  Features/
    Feed/           Feed list, filter bar, view model
    StoryDetail/    Story header + threaded collapsible comments
    Search/         Search with relevance/recency
    Saved/          Bookmarks
    Settings/       Appearance, reading, accessibility, data, about
    User/           Profiles
    Onboarding/     Smart first-run personalization
Resources/          Assets, app icon, Info.plist
Tools/              Icon generator, screenshot device-framer

# 1. Generate the Xcode project from project.yml
xcodegen generate

# 2. Open it
open Ember.xcodeproj

# 3. Select the Ember scheme and an iPhone simulator, then Run.

xcodegen generate
xcodebuild -project Ember.xcodeproj -scheme Ember \
  -sdk iphonesimulator \
  -destination 'platform=iOS Simulator,name=iPhone 17 Pro' build

swift Tools/GenerateIcon.swift                                   # app icon
swift Tools/FrameScreenshot.swift in.png docs/screenshots/x.png  # device-framed screenshot