FeedReader icon

FeedReader

A native iOS RSS feed reader with offline caching, bookmarks, search, and a Swift Package for embedding in your own apps.

Platform Swift CI License Release
View on GitHub Get Started →

Features

Everything you need in a feed reader — plus a Swift Package to bring RSS parsing to your own iOS apps.

📰

RSS Feed Parsing

Native XMLParser-based RSS reader with concurrent multi-feed loading and automatic deduplication.

💾

Offline Caching

Stories persisted via NSCoding. Read without internet. Smart cache invalidation on refresh.

📡

Multi-Feed Support

Add, remove, toggle, and reorder feeds. 10 built-in presets plus custom URL support.

🔖

Bookmarks

Save stories for later. Swipe-to-bookmark, dedicated bookmarks screen, persistent storage.

🔍

Search & Filter

Real-time search across story titles and descriptions. Find what you're looking for instantly.

🖼️

Async Image Loading

Story thumbnails load asynchronously with NSCache-backed in-memory caching for smooth scrolling.

🌐

Network Detection

Uses SCNetworkReachability to detect connectivity and gracefully switch between online and cached modes.

📦

Swift Package

Core RSS parsing available as FeedReaderCore SPM package. Embed in your own iOS apps with zero UI dependency.

🛡️

URL Validation

All URLs validated against allowed schemes. Rejects javascript:, file:, data: and other injection vectors.

Quick Start

Clone, open, and run in under 30 seconds.

# Clone the repository git clone https://github.com/sauravbhattacharya001/FeedReader.git # Open in Xcode cd FeedReader open FeedReader.xcodeproj # Build and run Press ⌘R to build and run on an iPhone simulator # Run tests Press ⌘U to run all tests

Swift Package

Use FeedReaderCore in your own iOS apps — RSS parsing without the UI.

// Package.swift dependencies: [ .package(url: "https://github.com/sauravbhattacharya001/FeedReader.git", from: "2.0.0") ] // In your Swift file import FeedReaderCore let parser = RSSParser() let stories = parser.parseData(xmlData) // [RSSStory] for story in stories { print(story.title) print(story.body) // HTML-stripped print(story.link) print(story.imagePath) // Optional thumbnail }

Full API Reference →

Built With

🍎 Swift 📱 UIKit 📦 Swift Package Manager 🔗 XMLParser 📡 URLSession 💾 NSCoding 🖼️ NSCache 🌐 SystemConfiguration ⚙️ GitHub Actions CI

Documentation

Everything you need to use, extend, and contribute to FeedReader.

🚀

Getting Started Guide

Installation, running the app, configuration, testing, and customization.

 📖

API Reference

Complete reference for FeedReaderCore: RSSParser, RSSStory, FeedItem, NetworkReachability.

 🏗️

Architecture

How the app is structured — data flow, MVC patterns, threading model, caching strategy.