- Kotlin 90%
- TypeScript 5%
- Svelte 3%
- HTML <1%
- CSS <1%
- 1 more language <1%
Feedarr #
Monorepo for Feedarr.
Structure #
feedarr-api/— Kotlin + Micronaut API server (Gradle, Kotest)webapp/— web app (Bun + Vite + Svelte 5 + TypeScript)
feedarr-api #
cd feedarr-api
./gradlew run # start the dev server
./gradlew test # run tests
Feeds #
The API turns any public Refract list into Radarr/Sonarr "Custom Lists" import list
feeds. The list is chosen per request with the slug query parameter (the slug is the
part after /list/ in a Refract list URL), so no configuration or rebuild is needed
to use a different list:
GET /feeds/radarr/movies?slug={refract-list-slug}→[{"id": ...}]GET /feeds/sonarr/tv?slug={refract-list-slug}→[{"title": ..., "tvdbId": ..., "tmdbId": ...}](tvdbId is resolved via Sonarr's SkyHook service and cached; stable Sonarr versions cannot resolve tmdbId themselves)- Append
/_itemsto either path for a debug view of all items incl. skipped ones GET /health→ micronaut-management health endpoint with a feedarr indicator (cache snapshot, last upstream outcomes — never calls Refract), plus the k8s probesGET /health/livenessandGET /health/readiness
Responses are cached per slug (application.cache-ttl, default 30m; stale payloads are
served if Refract is unreachable). The API is fully non-blocking, written with Kotlin
coroutines (suspend) end to end — client, service, and controllers. Configure
application.refract-base-url and application.cache-ttl in application.yaml.
See ROADMAP.md for details.
Docker #
The image is published as joaomiguelcorreia/feedarr:latest on Docker Hub
(only latest for now — versioning comes once the project stabilizes). It is a
GraalVM native image: ~143MB, ~20ms startup.
cd feedarr-api
./gradlew dockerBuildNative --no-configuration-cache # build joaomiguelcorreia/feedarr:latest locally
./gradlew dockerPushNative # push to Docker Hub (requires docker login)
Run it (config can be overridden via env vars, e.g. APPLICATION_CACHE_TTL
or APPLICATION_REFRACT_BASE_URL, matching the application.* config prefix):
docker run -p 8080:8080 joaomiguelcorreia/feedarr:latest
# then point Radarr/Sonarr at http://<host>:8080/feeds/...
webapp #
Svelte 5 + TypeScript on Vite, run with Bun.
cd webapp
bun install # install dependencies
bun dev # start the dev server (http://localhost:5173)
bun run build # production build into dist/
bun run check # type check (svelte-check + tsc)
In development, Vite proxies /api/* to feedarr-api on http://localhost:8080,
stripping the /api prefix (see webapp/vite.config.ts). Override the backend
origin with FEEDARR_API_URL in webapp/.env.