Foragd

A beautiful, web based, online feed reader.
Keep your RSS, Atom, and other syndication sources in one place — stay up to date across mobile, tablet, desktop, and laptop.

foragd.app »

• 📔 Table of Contents
• 🌟 About the Project
  • What Makes Foragd Different?
  • 📷 Screenshots
  • 👾 Tech Stack
  • 🎯 Features
• 🧰 Getting Started
  • ‼️ Prerequisites
  • ⚙️ Installation
  • 🧪 Running Tests
  • 🏃 Run Locally
  • 🚩 Deployment
• 👀 Usage
• 👋 Contributing
  • 📜 Code of Conduct
• ⚠️ License
• 🤝 Contact
• 💎 Acknowledgements

Foragd is an online, web-based feed reader for all syndication formats (RSS, Atom, JSONFeed).

• Focused on reading content, not tracking totals. No shoehorning feeds into an email-like inbox, no unread-count badges to chase. Just a straightforward homepage, subscription view, and article view.
• Powerful search. Fast, full-text search across subscriptions and articles — find that one article, from that one site, about that one thing, without digging.
• Easy filtering. Filter articles within a subscription by keyword, phrase, category, or author, using simple +/- operators — no complex filter builder required. For example: alcoholic drinks + -"rum based" +daiquiri

Server

• Go
• Chi
• templ
• htmx
• Tailwind CSS
• Daisy UI

Data store

• Elasticsearch

Backend services

• Auth0 — authentication
• Stripe — billing
• Resend — transactional email

• Mobile and desktop friendly. Foragd is a web based app that works in any modern browser, on any device.
• Article filtering. Filter articles in a subscription by text/phrase, category, or author with simple, powerful operators.
• Content comes first. A simple UI, big images, and clean typography let the content shine.
• Powerful search. Full-text search across subscriptions and articles, with quick access and actions right from the search bar.
• Subscription customisation. Give subscriptions a nickname and organise them with your own categories.
• Favorites. Mark subscriptions and articles as favorites for quick access later.
• Grouped subscriptions. Combine multiple subscriptions into a single unified view — great for following several sources on the same topic.
• Search subscriptions. Save a search as a subscription so new matching articles keep showing up automatically. Perfect for tracking news or topics across many sources at once.

To run Foragd, you'll need:

• Podman or Docker
• An Elasticsearch instance
• An Auth0 account
• A Stripe account
• A Resend account
• A GCP project (for supporting cloud services)

TBA.

TBA.

TBA.

TBA.

Foragd is available today at foragd.app. Sign up, add your first feeds, and start reading.

Contributions are always welcome!

See contributing.md for ways to get started.

TBA.

Distributed under the AGPL-3.0-or-later License. See LICENSE for more information.

Immanent Tech — hello@immanent.tech

Project Link: github.com/immanent-tech/foragd

TBA.