https://github.com/immanent-tech/foragd
A beautiful, web based, online feed reader.
https://github.com/immanent-tech/foragd
atom feeds golang htmx rss syndication templ
Last synced: 2 days ago
JSON representation
A beautiful, web based, online feed reader.
- Host: GitHub
- URL: https://github.com/immanent-tech/foragd
- Owner: immanent-tech
- License: agpl-3.0
- Created: 2024-11-04T08:18:24.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-05-29T12:00:26.000Z (19 days ago)
- Last Synced: 2026-05-29T13:09:59.574Z (19 days ago)
- Topics: atom, feeds, golang, htmx, rss, syndication, templ
- Language: Go
- Homepage: https://foragd.app
- Size: 67.6 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
Foragd
A beautiful, web based, online feed reader.
Keep your RSS, Atom and other syndication sources in one place. Stay up to date with news, blogs and other online sources, across your mobile, tablet, desktop and laptop.
Homepage
# :notebook_with_decorative_cover: Table of Contents
- [:notebook\_with\_decorative\_cover: Table of Contents](#notebook_with_decorative_cover-table-of-contents)
- [:star2: About the Project](#star2-about-the-project)
- [What Makes Foragd Different?](#what-makes-foragd-different)
- [:camera: Screenshots](#camera-screenshots)
- [:space\_invader: Tech Stack](#space_invader-tech-stack)
- [:dart: Features](#dart-features)
- [:toolbox: Getting Started](#toolbox-getting-started)
- [:bangbang: Prerequisites](#bangbang-prerequisites)
- [:gear: Installation](#gear-installation)
- [:test\_tube: Running Tests](#test_tube-running-tests)
- [:running: Run Locally](#running-run-locally)
- [:triangular\_flag\_on\_post: Deployment](#triangular_flag_on_post-deployment)
- [:eyes: Usage](#eyes-usage)
- [:wave: Contributing](#wave-contributing)
- [:scroll: Code of Conduct](#scroll-code-of-conduct)
- [:warning: License](#warning-license)
- [:handshake: Contact](#handshake-contact)
- [:gem: Acknowledgements](#gem-acknowledgements)
## :star2: 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:** not trying to shoehorn feeds into an email-like interface and not showing unread counts. Straightforward homepage, subscription, and article views.
- **Powerful Search:** fast and powerful searching. Find that article mentioning that thing from that site a while back, easily.
- **Easy Filtering:** easily filter articles within a subscription by keyword, phrase, category, or author. No complex filter building, just easy `+/-` operators. For example: `alcoholic drinks + -"rum based" +daiquiri`
### :camera: Screenshots
### :space_invader: Tech Stack
Server
Database
Backend
### :dart: Features
- **Mobile and Desktop Friendly.** Foragd is a web based online app. It works in any browser on any device, anywhere.
- **Article Filtering.** Filter articles in subscriptions by text/phrase, category or authors, with easy to use operators.
- **Content Comes First.** Simple UI. Big images. Beautiful typography. Let the content shine.
- **Powerful Search.** Full-text search across subscriptions and articles. Quickly access subscriptions and perform actions from the search bar.
- **Subscription customisation.** Set a nickname for your subscriptions. Add your own categories to easily group and find similar content.
- **Subscription and article favorites.** Mark subscriptions and articles as favorites, to quickly access them later.
- **Group subscriptions.** Combine multiple subscriptions to present a unified view of articles from any of them. Make it easy to keep up with similar posts across different sources.
- **Search subscriptions.** Use the powerful search to find what you need. Save the search terms as a search subscription to always find new articles that match. Great for keeping track of news or topics across multiple subscriptions.
## :toolbox: Getting Started
### :bangbang: Prerequisites
- Podman/Docker.
- Elasticsearch.
- Auth0.
- Stripe.
- Resend.
- GCP.
### :gear: Installation
TBA.
### :test_tube: Running Tests
TBA.
### :running: Run Locally
TBA.
### :triangular_flag_on_post: Deployment
TBA.
## :eyes: Usage
TBA.
## :wave: Contributing
Contributions are always welcome!
See `contributing.md` for ways to get started.
### :scroll: Code of Conduct
TBA.
## :warning: License
Distributed under the AGPL-3.0-or-later License. See [LICENSE](./LICENSE) for more information.
## :handshake: Contact
Immanent Tech —
Project Link: [https://github.com/immanent-tech/foragd](https://github.com/immanent-tech/foragd)
## :gem: Acknowledgements