Siteforge/companion-app/README.md

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

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

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.