An iOS application for reading and managing RSS feeds, built with a focus on clean architecture, testability, and modern iOS development practices. The project is structured as a modular Swift Package with clear separation of concerns.
- Add, remove and manage RSS feeds
- View feed items with rich content support (images, descriptions)
- Background refresh and notifications for new items
- Favorite feeds management
- Explore curated feed suggestions
- Add and remove explore feeds to the feed list from the explore feeds tab
- Enhanced feed addition with top recommendations
- Debug panel for notifications and background tasks
- SwiftData persistence
- Comprehensive test coverage
- Clean, modular architecture
Left: Main feed list with all RSS feeds - Middle: Empty feeds view - Right: Add new feed screen with suggested feeds
Left: Favorites tab with starred feeds - Middle: Empty favorites view - Right: Feed items view showing article content
Left: Explore tab with suggested feeds to add - Right: Explore added feeds view showing no added feeds
Left: Explore tab with added feeds which can be removed - Right: Debug panel for testing notifications and background tasks
- swift-dependencies: Dependency management
- swift-concurrency-extras: Utilities for concurrent code
- swift-snapshot-testing: Snapshot testing framework
- Kingfisher: Image downloading and caching
- SwiftLint: Code style and conventions enforcement
- swift-format: Code formatting
The project is built as a Swift Package (RSSReaderKit) containing multiple modules:
- FeedListFeature: Main feed management UI
- FeedItemsFeature: Feed items display
- ExploreFeature: Feed discovery interface
- TabBarFeature: Main navigation structure
- FeedRepository: Handles feed related logic, fetching, parsing and persisting them locally
- NotificationRepository: Handles notifications and background refresh coordination
- RSSClient: RSS feed fetching and parsing
- PersistenceClient: SwiftData-based storage
- BackgroundRefreshClient: Background task scheduling and execution
- UserNotificationClient: System notification handling
- UserDefaultsClient: UserDefaults interaction
- Common: Utilities, and constants
- SharedModels: Data models used across modules
- SharedUI: Shared UI components
- Dependency Injection: Using Point-Free's Dependencies
- Modern Concurrency: Leveraging async/await and actors
- Repository Pattern: Abstracting data sources behind clean interfaces
- SwiftUI: Modern declarative UI with Observation framework
- Testing: Comprehensive unit and snapshot tests
- SwiftData: Native persistence with modern Swift data modeling
- iOS 17+
- Swift 6+
- Xcode 16+
- Clone the repository
- Run
make projectto initialize dependencies - Open
RSSReader.xcodeproj - Build and run
The project includes a comprehensive Makefile for development tasks:
make project # Runs install-tools, setup and open
make renew # Runs xcode-clean, clean, reset-packages, project
make setup # Initial project setup
make open # Open project in Xcode
make init-packages # Initialize local package dependencies
make reset-packages # Reset package caches
make lint # Run SwiftLint
make lint-fix # Fix SwiftLint violations
make format # Run swift-format
make clean # Clean build artifacts
make install-tools # Install required development tools
make test # Run tests and display basic test information- Optimize background task handling and scheduling logic
- Refine
BGTaskSchedulerinteraction with a mockable abstraction for improved testability - Add direct deep linking to articles and specific feeds
- Implement robust HTML content rendering within the app (e.g. for full article views)
- Add pagination or infinite scrolling for feed items lists
- Set up a CI/CD pipeline for automated builds, tests, and releases
- Enhance code coverage reporting (e.g. integrate with SonarQube or Codecov)
- Add code quality metrics and static analysis beyond SwiftLint
- Implement comprehensive UI tests for key user flows
- Performance profiling and optimization, especially for large numbers of feeds/items
- Add more granular error handling and user feedback for background processes
- Feed search and filtering capabilities
- Advanced dark mode optimization and theme customization
- Widget extensions for quick access to new items or favorite feeds
- Share sheet integration for articles
- OPML import/export for feed lists
- Pull-to-refresh gesture for feed lists and item lists
- Unread item tracking and management (mark as read/unread)
- Offline reading mode (caching article content)
- Customizable feed update intervals per feed or globally
- Grouping/categorizing feeds
- Define and implement a formal SwiftData migration strategy
- Integrate crash reporting (e.g., Sentry, Firebase Crashlytics)
- Expand and improve localization support for more languages
- Formalize and unify error presentation to the user across all modules (e.g. show smaller alerts for adding feeds not full screen, etc.)
For any questions please contact me via martino.mamich@gmail.com.
Check the debug tab in the app for testing notifications and background tasks. The app includes comprehensive logging and debugging tools for development.
This project is licensed under the MIT License - see the LICENSE file for details.
Copyright (c) 2025 Martino Mamić