Rosser is a self-hosted, cross-platform RSS reader. It brings a desktop client, a mobile H5 interface, and a unified web entry under one lightweight backend, so you can follow your feeds on your own infrastructure.

English | 中文说明

• Backend: FastAPI + SQLAlchemy(async) + SQLite + Alembic + APScheduler
• Desktop: Tauri + Vue3 + Vite + Naive UI
• Mobile: Vue3 + Vite + Tailwind CSS + Pinia + Vue Router + Vue I18n (H5, remote only)
• Shared: TypeScript monorepo package with OpenAPI-generated types

• uv (Python 3.12+)
• pnpm 9+
• Node.js 20+

# Install dependencies
pnpm install
cd src/backend && uv sync --extra dev

# Start everything (backend + frontend + mobile)
pnpm dev

cd src/backend
uv run python -m app.main

API docs available at http://127.0.0.1:8000/docs.

pnpm --filter @rosser/frontend dev:vite

# Development server
pnpm --filter @rosser/mobile dev

# Unit tests
pnpm --filter @rosser/mobile test

# E2E tests
pnpm --filter @rosser/mobile test:e2e

The project root includes a full-stack docker-compose.yml that starts the backend, the web frontend (remote mode), the mobile H5 app, and an optional unified entry proxy:

cp .env.example .env
# Edit .env, at least change ROSSER_TOKEN
docker compose up -d

After deployment:

• Backend API: http://localhost:8000
• Frontend standalone: http://localhost:8001
• Mobile H5 standalone: http://localhost:8002
• Unified entry (auto-routes to frontend/mobile by UA): http://localhost:8003

Unified entry rules:

• /api/* → backend API
• /ws → backend WebSocket
• / and static assets → desktop UA goes to frontend, mobile UA goes to mobile

When opening the frontend or mobile app for the first time, set the backend URL to http://localhost:8000 and enter ROSSER_TOKEN. If you access through the unified entry at http://localhost:8003, you can also set the backend URL to http://localhost:8003 (API requests are proxied to the backend automatically).

Backend data and files are persisted in the ./data and ./storage directory volumes at the project root. They survive container recreation and upgrades.

GPL-3.0