Scrollr
A pinned, always-on-top ticker for the things you actually care about.
Live market quotes, game scores, and RSS feeds — streaming into a compact
bar that floats on top of whatever you're working on. Multi-monitor aware.
No ads or data sales; analytics are limited and controllable.
What it looks like
Pick the sources you care about — each gets a focused view, and the
pinned ticker streams the same data across the top of your screen.
| |
|---|
| |
| Sports. Scores, schedules, and standings across MLB, NBA, NHL, NFL, and F1, all live. | Finance. Stocks, ETFs, and crypto with live quotes from TwelveData. |
| |
| News. Hacker News plus any RSS/Atom feed you throw at it. Categorized, deduped, sorted. | |
What's in this repo
Scrollr is a monorepo. The desktop app is the product; everything else
exists to feed it.
| Path | Service | Stack |
|---|
desktop/ | Desktop app (the primary product) | Tauri v2 + React 19 + Vite 7 |
myscrollr.com/ | Marketing, auth, billing — not where widgets are configured | React 19 + Vite 7 + TanStack Start (static prerender) |
api/ | Core API: widget catalog, reads, SSE, billing, accounts, support | Go 1.26 + Fiber v2 + Postgres + Redis |
channels/finance/ | Market-data ingester (TwelveData) | Rust |
channels/sports/ | Scores + schedules ingester (api-sports.io) | Rust |
channels/rss/ | RSS/Atom ingester | Rust |
k8s/ | Production manifests | Kubernetes on DigitalOcean |
scripts/ | Dev + ops tooling: make helpers, smoke tests, osTicket plugin | Node, Shell, PHP |
docs/ | Charter, ADRs, roadmap, runbooks — indexed here | Markdown |
How it fits together
┌──────────────────┐ ┌──────────────────┐
│ desktop app │ │ myscrollr.com │
│ (Tauri + React) │ │ (React + Vite) │
└────────┬─────────┘ └────────┬─────────┘
│ │
│ JWTs via Logto │
▼ ▼
┌─────────────────────────────────────────┐
│ Core API (api/ · Go · Fiber) │ ← only JWT validator
│ GET /catalog the widget catalog │ ← owns every shared table
│ /users/me/widgets widget CRUD │
│ /dashboard /events reads + SSE │
│ /checkout billing │
│ finance · sports · rss │ ← served in-process
└──┬────────────────────────────────────┘
│ writes
▼
shared Postgres ◀── Rust ingesters: finance · sports · rss
│ (pure writers — they run no migrations)
└── Sequin CDC → Redis pub/sub → SSE → ticker
- Core API is the only service that validates JWTs, and the only
thing that migrates the database. The ingesters are pure writers.
- The widget catalog is server-authoritative.
GET /catalog is the
single definition of what widgets exist. The desktop fetches it and
renders generically, so adding a widget that reuses an existing renderer
is a server-only change — no client release. The marketing site fetches it
too (useCatalog()) and keeps a snapshot as the offline and prerender
fallback.
- No proxied channel service remains. Finance, sports and rss were
folded into core by
ADR-0002; fantasy was
the last separately-deployed service and was removed outright
(SCROLLR-239), along with the Redis service discovery and dynamic proxy
that only it used.
- Data flows back via CDC. Sequin streams Postgres changes to Redis
topics; every core replica fans them out to connected desktops over
SSE (ADR-0001).
Read api/CHANNELS.md for the widget/source model
and how to add one.
Quick start — just run the desktop app
Head to https://myscrollr.com/download and grab the build for your
OS. macOS builds are signed and notarized. Windows signing is tracked
separately; the download page carries the current installation guidance.
Quick start — local development
make setup # generate every .env file (once)
make up # start the whole backend in Docker
make dev # ...and open the site + desktop app
make on its own lists every command, grouped.
You need Docker Desktop, Node 22+ and make — that's it. No Go
or Rust toolchain: the backend compiles inside its containers, and editing
a .go or .rs file hot-reloads that service in place rather than
requiring a rebuild. make doctor checks your machine and names the fix
for anything missing.
The two front-ends run natively (a GUI window can't live in a Linux
container). Full topology, ports and troubleshooting:
docs/LOCAL_SETUP.md.
Testing
make check # both TypeScript suites — the ones that run without a toolchain
This is the beginning of the README. Read the rest at the original. Read the full README ↗
