11feed
11feed is an open-source, self-hosted, minimal RSS reader built with the static site generator 11ty.
Core Principles
- No ads, upsells, or feature bloat
- Encourage the culture of blogging, sharing, and discovery through RSS.
- Generate a purely static site that can be hosted publicly on any web server.
- Keep features, dependencies, and the implementation to the bare essentials.
- Provide a solid base for others to build on and customize for their own needs.
- Emphasis on security.
Quick Start
-
Clone the repository
git clone https://github.com/cloudcannon/11feed.git cd 11feed -
Install dependencies
npm install -
Configure your RSS feeds
JSON Configuration: Place a
.jsonfile with your feeds in./src/_feeds/:{ "category": "Web", "items": [ "https://zachleat.com/web/feed/", "https://www.smashingmagazine.com/feed/" ] }OPML Import: Put your OPML export in
./src/_feeds/:<?xml version="1.0" encoding="UTF-8"?> <opml version="2.0"> <head> <title>Feed List</title> </head> <body> <outline text="Web"> <outline type="rss" text="Zach Leatherman's Blog" xmlUrl="https://zachleat.com/web/feed/" /> <outline type="rss" text="Smashing Magazine" xmlUrl="https://www.smashingmagazine.com/feed/" /> </outline> </body> </opml> -
Build
To build:
npx @11ty/eleventyTo build and serve on
localhost:8080:npx @11ty/eleventy --serve -
Deploy
Deploy your site to a static hosting provider. Each platform offers ways to schedule daily builds:
Useful Resources
- 11ty Documentation - Learn more about how to use 11ty.
- Explore RSS feeds in your neighbourhood - Finds RSS feeds from people you follow on the Fediverse.
- List of frontend feeds - Another way to discover new people to follow.
Contributing
We welcome contributions! Whether it's feature suggestions, bug reports, or pull requests, all contributions are appreciated. Please submit an issue or pull request if you'd like to improve 11feed.
License
11feed is open source and available under the MIT License.