Feedo

Offline-first RSS reader with AI summaries.

Features

• Offline-first with IndexedDB
• AI summaries (local WebGPU or API)
• Auto-untruncation and full-text extraction
• OPML import/export
• Rules engine
• Background sync
• PWA with offline support
• Dark mode UI

Quick Start

Prerequisites

• Node.js 20+
• pnpm 9+
• Docker & Docker Compose
• Python 3.11+ (optional for local worker dev)

Setup

# Fork repo at https://github.com/yourusername/feedo
git clone https://github.com/zhravan/feedo.git
cd feedo
make setup

Configure SMTP in infra/.env for email magic links.

Development

make dev

Then in separate terminals:

# Terminal 1 - Worker
cd apps/worker && poetry run python main.py

# Terminal 2 - Web
cd apps/web && pnpm dev

Access at http://localhost:3000

Production

make prod

Everything runs in Docker. Access at http://localhost:3000

Commands

make setup    # Install dependencies
make dev      # Start dev environment
make prod     # Start production environment
make clean    # Clean all artifacts

Tech Stack

Frontend: Next.js 15, TypeScript, Tailwind CSS, Dexie, MiniSearch, Zustand, Framer Motion, Phosphor Icons

Backend: FastAPI, feedparser, readability-lxml, Poetry

Infrastructure: PostgreSQL, Redis, MeiliSearch, Docker

Project Structure

feedo/
├── apps/
│   ├── web/        # Next.js PWA
│   └── worker/     # FastAPI service
├── packages/
│   ├── ui/         # Components
│   ├── core/       # Business logic
│   └── db/         # Prisma schema
└── infra/          # Docker Compose

Documentation

• Contributing
• Infrastructure
• Worker API

License

MIT