Turn RSS feeds into a personal news reader

A free, self-hosted Nuxt layer that aggregates RSS feeds into a newspaper-style homepage. Filter by keywords, pick your sources, and customize the design.

View on GitHub Open live demo

Features

A free, self-hosted RSS reader you control—no subscriptions, no middleman.

Free & self-hosted

Deploy on your own stack with Nuxt. Open source, no subscription fees, no vendor lock-in.

No paid RSS reader

RSS feeds are free—skip Feedly, Inoreader, and other monthly subscriptions.

Keyword filters

Include or exclude articles by keywords in titles and summaries—cut noise, keep what matters.

Full control

Choose your sources, tune filters, and override pages and components to match your design.

Newspaper-style homepage

Masthead, hero cards, headline list, and sidebar—ready out of the box.

RSS aggregation API

Server route at /api/news fetches feeds, dedupes, filters, and sorts articles.

Customizable layout

Override pages and components in your app to tailor the layout and UI without forking the layer.

Production-ready caching

Homepage and API cached with SWR for 10 minutes in production.

Get started

Extend the layer and add your RSS feeds—that's all you need.

export default defineNuxtConfig({
  extends: ["github:bansal/journal"],
  appConfig: {
    journal: {
      newsSources: [
        {
          id: "hn",
          name: "Hacker News",
          url: "https://hnrss.org/frontpage",
          link: "https://news.ycombinator.com",
          category: "Tech",
        },
      ],
    },
  },
});

Star Config reference

Build your own news reader

Host your own reader for free. Add your RSS feeds, filter by keywords, and customize everything.

View on GitHub Open live demo