BPTimer

A web panel and companion app for Blue Protocol: Star Resonance to view mob uptimes and track them in real-time.

Quick Start

Requirements: Bun, Docker

git clone https://github.com/woheedev/bptimer.git
cd bptimer
bun install

Set up environment variables for web panel:

cp ./apps/web/.env.example ./apps/web/.env

Fill in ./apps/web/.env:

• PB_ADMIN_EMAIL and PB_ADMIN_PASSWORD for the PocketBase admin (password must be 8+ characters)
• PUBLIC_POCKETBASE_BASE_URL=http://localhost:8090
• PB_OAUTH2_DISCORD_CLIENT_ID and PB_OAUTH2_DISCORD_CLIENT_SECRET from Discord Developer Portal
  • Add http://localhost:8090/api/oauth2-redirect as a redirect URL

Start everything:

bun run dev

This starts both the PocketBase backend (via Docker) and the vite dev server.

Open http://localhost:5173 and log in via Discord.

Apps

| App | Description | | ------------------------------------ | ----------------------------------------------------------------------------- | | apps/web | SvelteKit web app (currently deployed to Cloudflare) | | apps/pocketbase | PocketBase backend with custom Go hooks (deployed behind a Cloudflare Tunnel) | | apps/desktop | Native overlay companion app for mob / dps tracking (Rust/egui) |

Packages

| Package | Description | | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- | | packages/bptimer-api-client | API client for submitting boss HP data (npm) |

Production

For production deployments:

• Web: Deploy to Cloudflare (or any platform that can host a static SvelteKit app). Set PUBLIC_POCKETBASE_BASE_URL to your production PocketBase URL.
• PocketBase: Run via Docker on any VPS. Configure SMTP for emails and update Discord OAuth redirect URL. Can also run binary directly ideally using Systemd service.