Files
hyprcrd/electron
thandClaude Opus 4.6 1d6499e5dd extract sync orchestration into sync.js, unify on sync.tick heartbeat
caldav.js was carrying the core sync timer, autosync toggle, relay
settings and every poller hook alongside its actual CalDAV/calendar
config concerns. Split out:

- New sync.js owns the single background timer, header Sync button,
  autosync pause toggle, configurable interval, and emits `sync.tick`
  so plugins can fan out without their own setIntervals.
- collab-buckets + chat now subscribe to sync.tick instead of running
  their own pollers, so the manual Sync button refreshes them too and
  the Autosync pause actually pauses everything.
- Replace the number input for sync interval with a stepped slider
  (5s..1h snap points) and a live label, bumped to 1.9.2.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 19:02:44 +02:00
..
2026-04-12 16:09:34 +02:00
2026-04-12 16:09:34 +02:00
2026-04-12 16:09:34 +02:00
2026-04-12 16:09:34 +02:00
2026-04-12 18:00:06 +02:00

hyprcrd — Electron Desktop App

Wraps the PHP backend in an Electron shell. A static PHP binary is bundled per platform so users don't need PHP installed.

How it works

  1. On launch, the app starts PHP's built-in server on a random port (127.0.0.1)
  2. router.php replaces Apache's .htaccess rewrite rules
  3. A BrowserWindow loads http://127.0.0.1:<port>/
  4. On quit, the PHP process is killed cleanly

User data (database + uploads) is stored outside the app bundle so it survives updates:

  • Dev: electron/appdata/
  • Linux: ~/.config/hyprcrd/data/
  • macOS: ~/Library/Application Support/hyprcrd/data/
  • Windows: %APPDATA%/hyprcrd/data/

Development

cd electron
npm install
npm start          # launches the app using system or bundled PHP

Requires PHP 8.1+ with pdo_sqlite and zip extensions — either on the system PATH or as a static binary in php-bin/<platform>/.

Bundling PHP

Static PHP binaries are not checked into git. Fetch them before building:

./fetch-php.sh     # downloads ~20MB per platform from static-php-cli

Or place them manually (see php-bin/README.md for sources):

php-bin/linux/php
php-bin/darwin/php
php-bin/win32/php.exe

The app prefers the bundled binary. If none is found, it falls back to system PHP. If neither exists, a dialog tells the user what to install.

Building distributables

npm run dist

Uses electron-builder. Output:

Platform Format Location
macOS .dmg dist/
Windows NSIS dist/
Linux AppImage dist/

File structure

electron/
  main.js          Electron main process — spawns PHP, creates window
  preload.js       Exposes window.hyprcrdElectron (platform, isElectron)
  router.php       PHP built-in server router (replaces .htaccess)
  fetch-php.sh     Downloads static PHP binaries for all platforms
  php-bin/         Platform-specific PHP binaries (gitignored)