Code Architecture

vidarch/
├─ client/                 React interface and demo mode
│  └─ src/
│     ├─ components/       cards, player, navigation, and dialogs
│     ├─ context/          shared state and common requests
│     ├─ pages/            application screens
│     └─ demo/             static data and behaviours
├─ server/
│  └─ src/
│     ├─ routes/           endpoints Express
│     ├─ services/         yt-dlp, queue, and scanner
│     ├─ db/               SQLite schema and migrations
│     └─ utils/            paths, metadata, and security
├─ scripts/                local startup
├─ Dockerfile
└─ docker-compose.yml

server/src/index.ts initializes the database, HTTP protections, rate limits, routes, and the production static server.

The client does not use an external router: VidArch navigation state is translated into URLs by its utilities and context.