rssCloud

A monorepo for the rssCloud notification protocol.

Packages

• apps/server — rssCloud Server: an Express implementation of the rssCloud notification protocol. Handles subscriptions, ping, and notifications for RSS feed updates.
• apps/client — a private, interactive dev harness for the rssCloud client: a Subscribe/Ping UI with a request log that hosts a notify endpoint and drives a server. Not published.
• packages/core — @rsscloud/core: shared primitives for subscriptions, notifications, and feed processing.
• packages/express — @rsscloud/express: Express middleware for the rssCloud front doors — pleaseNotify, ping, and the RPC2 endpoint, built on @rsscloud/core.
• packages/xml-rpc — @rsscloud/xml-rpc: a generic XML-RPC codec — parse and build methodCall/methodResponse documents.

Development

This repo is a pnpm workspace using Turborepo for task orchestration. Node.js 22+ is required.

git clone https://github.com/rsscloud/rsscloud-server.git
cd rsscloud-server
corepack enable
pnpm install
pnpm start          # start the server in dev mode
pnpm build          # build all packages
pnpm lint           # lint all packages
pnpm typecheck      # typecheck all packages
pnpm test:unit      # run unit tests across all packages
pnpm test           # run docker-based end-to-end tests (server)

See each package's README for package-specific usage and API documentation.