Files
hyprcrd/electron
thandClaude Opus 4.6 c934673c4a detail: optional bucket-switch on open from search / link
New toggle under Settings → Behavior → Interactions: "Switch to
card's bucket on open (search / link)". When enabled, openDetail
calls activateBucket(card.bucket_id) so the board and bucket bar
update to show the card's context. Skipped when already on 'all'
or the correct bucket. Default off.

Uses activateBucket() (from buckets.js) instead of raw state
assignment so the bucket-bar highlight tracks the switch.

Tests: two cases — setting on switches activeBucket + verifies the
bucket-tab.active in the bar matches; setting off leaves the
bucket unchanged. Both create/delete probe cards in try/finally
and restore the setting + activeBucket in afterEach.

Bumps to 1.9.27.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-16 23:39:36 +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)