rss-reader/README.md

RSS Reader

A modern web-based RSS feed reader built with Rust and Rocket. Features a clean, dark-themed interface that allows you to:

• Add and manage RSS/Atom feeds
• View feed entries with titles, summaries, and timestamps
• Poll feeds for updates
• Organize feeds with categories
• Multi-user support with admin capabilities

Installation

Using Nix

This project is packaged with Nix flakes. To install and run it:

1. Make sure you have Nix installed with flakes enabled. Add this to your /etc/nix/nix.conf if you haven't already:

   experimental-features = nix-command flakes
   

2. Install the package:

   nix profile install git+https://code.everydayimshuflin.com/greg/rss-reader
   

   Or run it directly:

   nix run git+https://code.everydayimshuflin.com/greg/rss-reader -- -d /path/to/database.sqlite
   

Development

To set up a development environment:

1. Clone the repository:

   git clone https://code.everydayimshuflin.com/greg/rss-reader.git
   cd rss-reader
   

2. Enter the development shell:

   nix develop
   

3. Run the application:

   cargo run -- -d rss-reader.db
   

The application will be available at http://localhost:8000. On first run, you'll be prompted to create an admin user.