rss.mobi
rss.mobi is a directory of RSS feeds with a mobile
reader and a feed API. Anyone can submit a feed: it is found from a site or
feed address, read, and live straight away, with no account and no review
queue. Each feed gets a page with its latest posts and one-tap links to
follow it in Feedly, Inoreader, NetNewsWire or any other reader — or in
the site's own reader, which keeps its list on the phone. Several feeds
can be combined into one collection with its own RSS feed and OPML file.
Astro (server output) on Vercel, MongoDB, Vercel Cron Jobs. Feeds are parsed
from RSS 2.0, RSS 1.0 (RDF), Atom and JSON Feed.
Run it
Node 24 and Docker. MongoDB 7 runs locally; 8 refuses to start on some
Docker Desktop kernels.
docker run -d --name rss-mobi-mongo7 -p 127.0.0.1:27018:27017 \
-v rss-mobi-mongo7:/data/db mongo:7
cat > .env.local <<'X'
MONGODB_CONNECTION_STRING=mongodb://127.0.0.1:27018/?directConnection=true
MONGODB_DB=rssmobi_dev
CRON_SECRET=dev-cron-secret-0123456789
X
npm install
npm run migrate
npm run dev # http://localhost:4340
Submit a feed at /submit/, then poll by hand:
curl -X POST localhost:4340/api/v1/cron/fetch \
-H "Authorization: Bearer dev-cron-secret-0123456789" \
-H "Content-Type: application/json" -d '{}'
Test
npm test # unit tests, no services needed
RSS_MOBI_BASE=http://localhost:4340 npm run test:live
npm run seo -- http://localhost:4340 # titles, sitemaps, robots
test:live fetches every page type as Googlebot and as a phone and fails
if the HTML differs: nothing here may show a crawler something else than a
reader.
Contributing
Issues and pull requests are welcome. Code, comments and docs are in
English. A change is ready when npm test passes, npm run seo is clean
and CHANGELOG.md says what changed; AGENTS.md lists the rules that are
easy to break. Security problems: see SECURITY.md, not a
public issue.
Licence
GNU Affero General Public License v3.0. If you run a modified
version as a service, its users are entitled to its source.
