Add companion app

2026-04-20 14:58:57 -04:00
parent 0c328057c8
commit 74c21f956e
18 changed files with 2977 additions and 0 deletions
@@ -0,0 +1,42 @@
+# Verse by Verse Companion App
+
+This is a standalone companion app for your podcast.
+
+It is intentionally separate from the main Siteforge app and has its own dependencies, scripts, and Vite config.
+
+Episodes are loaded at runtime from your RSS feed:
+
+- https://anchor.fm/s/11068d290/podcast/rss
+
+This means new podcast episodes appear in the app without rebuilding the frontend.
+
+## Run locally
+
+```bash
+cd companion-app
+npm install
+npm run dev
+```
+
+The app runs on `http://localhost:5181`.
+
+`npm run dev` starts:
+
+- Vite web app on `http://localhost:5181`
+- RSS API on `http://localhost:4174`
+
+## Production build
+
+```bash
+cd companion-app
+npm run build
+npm run start
+```
+
+`npm run start` serves the built app and RSS API from one Node process.
+
+## Runtime API
+
+- Endpoint: `/api/episodes`
+- Source feed: Anchor RSS URL above
+- Fallback: If RSS is unavailable, the app uses local fallback episodes from `src/data/podcastData.ts`.