Readflow is an open-source read-it-later and news reader app that centralizes articles from various sources for distraction-free, offline reading.

---

🚀 Overview

Readflow is a versatile news-reading and read-it-later solution that lets you collect articles from anywhere—via RSS, Pocket, webhooks, or other integrations—and read them in one clean, ad-free place. It cleans content, supports offline saving, and allows exports to formats like PDF, EPUB, and more.

It solves the problem of scattered web content and fragmented reading experiences by providing a simple PWA that works seamlessly on desktop and mobile, with powerful organization tools like categories and scripting.

Built for avid readers, researchers, and self-hosters who value privacy and customization without trackers or ads. Created by Nicolas Carlier to emphasize simplicity, versatility, and user freedom.

---

✨ Key Features

• Collect articles from anywhere using incoming webhooks (RSS, Pocket, Shaarli, Wallabag, S3, etc.) and customize with scripting
• Distraction-free reading interface with PWA support for all devices, offline reading capabilities
• Organize articles into categories, reading flows (unread/to-read), and get notifications for new content
• Export articles locally in HTML, PDF, EPUB, ZIP formats; outgoing webhooks for integrations
• GraphQL API for advanced use, CLI tool (readflow-ctl), and experimental AI/LLM integration via MCP

---

🛠 Tech Stack

• Frontend: React, TypeScript, CSS, JavaScript, HTML
• Backend: Go
• Database: PostgreSQL
• Auth: Basic Auth / OIDC Device Code Flow (CLI)
• Hosting: Docker, self-hosted; Hosted at readflow.app

---

👥 Who Is This For?

This project is useful for:

• Developers who want to self-host a customizable read-it-later service
• Avid readers looking for an ad-free, privacy-focused article aggregator
• Productivity enthusiasts building personal knowledge management systems

---

📸 Screenshots / Demo

• Live demo: https://readflow.app (sign up/login required)
• GitHub: https://github.com/ncarlier/readflow (Docker Compose demo with demo/demo user)

---

🔥 Project Status

• 🟡 Maintained

Last updated: 2024-03-04

---

❓ FAQ

Is this project free?

Open Source (self-hosted is completely free). Hosted SaaS at readflow.app appears to be subscription-based (details not publicly listed). (Explain briefly.)

---

Is the source code available?

Yes — https://github.com/ncarlier/readflow

---

Can I contribute?

Yes — report bugs via issues, submit pull requests, or share feedback on GitHub. Development uses Make, Docker, and Git submodules.

---

📬 Contact & Links

• Website: https://readflow.app
• GitHub: https://github.com/ncarlier/readflow
• Twitter/X: N/A
• Email: Via GitHub issues (Nicolas Carlier)

---

Built with ❤️ and kept warm on WarmIndex.