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

• 📔 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

🌟 About the Project

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

What Makes Foragd Different?

• 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

📷 Screenshots

👾 Tech Stack

Server

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

Data store

• Elasticsearch

Backend services

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

🎯 Features

• 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.

🧰 Getting Started

‼️ Prerequisites

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)

⚙️ Installation

TBA.

🧪 Running Tests

TBA.

🏃 Run Locally

TBA.

🚩 Deployment

TBA.

👀 Usage

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

👋 Contributing

Contributions are always welcome!

See contributing.md for ways to get started.

📜 Code of Conduct

TBA.

⚠️ License

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

🤝 Contact

Immanent Tech — hello@immanent.tech

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

💎 Acknowledgements

TBA.