The server admin panel for flick — analytics, user management, events, and the user-site announcement banner. Fully isolated from the user app: its own repo, its own port, bearer-only auth against /api/admin/* (CONTRACTS.md › Admin API).
Built on corepanel as a dependency, not a fork — this repo is just providers + page config (~200 lines).
- Overview — users/guests, actives (1d/7d/30d), words + readers + signups per day, WPM distribution, top books, DB size, server version/uptime. Auto-refreshes.
- Users — search, paging, promote/demote admins, plan, delete (cascade).
- Events — the referral/free-pro/promo events, end them early.
- Announcement — the banner shown on the user site; publish/unpublish with a toggle.
 |
 |
flowchart LR
op["operator"] -- "admin.myflick.app<br/>(or :8485 self-host)" --> n["nginx<br/>flick-admin container"]
n -- "static panel" --> op
n -- "proxy /api" --> b["flick-backend:8484<br/>shared podman/compose network"]
b --> db[("SQLite")]
Same-origin by design: the panel and its /api come from one host, so no CORS is needed. (Serving the panel elsewhere works too — set FLICK_ADMIN_ORIGIN on the backend.)
- Admin users — accounts with
is_admin(flip it in the users table, or bootstrap below). Email + password; sessions expire after 12 h. - The env token —
FLICK_ADMIN_TOKENas break-glass "use an admin token instead".
Bootstrap the first admin with the token: sign in with it, open users, hit make admin on your account.
Needs flick-backend on :8484 (Vite proxies /api).
bun install && bun run dev # http://localhost:5175
bun run check && bun run buildStatic build + nginx that proxies /api to the backend container (deploy/):
podman build -t flick-admin https://github.com/one-more-refactor/flick-admin.git -f deploy/ContainerfileQuadlet units in deploy/ put it on 127.0.0.1:3013 behind your tunnel/proxy, joined to the backend via a shared flick network. Set on the backend: FLICK_ADMIN_ORIGIN=https://admin.your.domain (CORS, only needed if the panel is NOT proxied same-origin) and FLICK_ADMIN_URL=https://admin.your.domain (adds the ADMIN link to the user app's account menu).