WatchLink/blueprint.md

# WatchLink

WatchLink is a self-hosted shared-watch web app with persistent user rooms, local accounts, friends, role-based administration, and realtime playback state.

{{ template:section-line }}

## Features

- First-run admin setup
- Username/password accounts
- Persistent user rooms
- Friend graph and access modes
- Shared playback state for YouTube, Twitch, and direct video URLs
- Uptime Kuma/Dockge-inspired app shell
- Dockerized Next.js and Postgres stack

{{ template:section-line }}

## Development

```bash
npm install
cp .env.example .env
npm run db:push
npm run dev
```

{{ template:section-line }}

## Docker

```bash
docker compose up --build
```

Target image: `git.wilkensxl.de/mrsphay/watchlink:latest`