About this project

Foragd is an online, browser-based feed reader that collects syndication sources such as RSS, Atom and JSONFeed in one place, with the stated goal of staying readable across mobile, tablet, desktop and laptop. A hosted instance is available at foragd.app. Positioning The README describes a deliberate departure from inbox-style readers: content comes first rather than unread counters, with a simple homepage, a subscription view and an article view. Two capabilities are highlighted. The first is full-text search across subscriptions and articles, including quick actions from the search bar. The second is article filtering inside a subscription using simple plus/minus operators for text or phrases, categories and authors; the README gives the example query: alcoholic drinks + -"rum based" +daiquiri, presented as an alternative to a filter builder UI. Other documented features Mobile- and desktop-friendly layout in modern browsers; subscription customisation through nicknames and user-defined categories; favorites for subscriptions and articles; grouped subscriptions that merge several sources into one unified view; and saving a search as a subscription so new matching articles appear automatically. Tech stack Server side: Go, Chi router, templ, htmx, Tailwind CSS and Daisy UI. Data store: Elasticsearch. Backend services: Auth0 for authentication, Stripe for billing, Resend for transactional email. Running and deployment Prerequisites listed are Podman or Docker, an Elasticsearch instance, Auth0, Stripe and Resend accounts, plus a GCP project for supporting cloud services. The README marks installation, running tests, local run and deployment sections as TBA, so no step-by-step self-hosting procedure is documented at this time; the practical path described is signing up at foragd.app, adding feeds and reading. Contributing, license and contact Contributions are welcomed via the repository, with a contributing.md referenced for getting started; the code of conduct section is also marked TBA. The project is distributed under the AGPL-3.0-or-later license. Contact is Immanent Tech at hello@immanent.tech, and the project link is github.com/immanent-tech/foragd. Acknowledgements section is TBA.