@deltaroboticsinc/protoboard 0.1.0

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2026 Delta Robotics Inc. All rights reserved.
+
+This software is the proprietary property of Delta Robotics Inc.
+Use, copying, modification, distribution, sublicensing, or any other
+exploitation of this software, in whole or in part, is prohibited
+without the prior written permission of Delta Robotics Inc.
+
+This software is published to the npm registry solely to make
+installation convenient for Delta Robotics employees and explicitly
+authorized collaborators. Public availability on the registry does
+not constitute a grant of any rights under this notice.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,69 @@
+# protoboard-desktop
+
+Downloadable, self-hostable build of Protoboard for desktop or sandbox use.
+
+Until the full desktop build lands, this repo ships **`@deltaroboticsinc/protoboard`** — a one-command installer that registers the `.protoboard` file type with its logo and a double-click handler on Windows, macOS, and Linux.
+
+## Quickstart
+
+```sh
+npx @deltaroboticsinc/protoboard install
+```
+
+That's it. Save a `.protoboard` file anywhere (Desktop, Downloads, wherever) and it will show the Protoboard mark. Double-clicking opens the board in your default browser at `https://alpha.protoboard.xyz/open?boardId=...`.
+
+To remove:
+
+```sh
+npx @deltaroboticsinc/protoboard uninstall
+```
+
+No admin/root required. All registration is per-user.
+
+## How it works
+
+- **Windows** — writes per-user keys under `HKCU:\Software\Classes`; copies `ProtoboardFile.ico` and a launcher `Open-Protoboard.ps1` into `%LOCALAPPDATA%\Protoboard\`. Double-click runs the launcher, which reads `board.metadata.id` from the JSON and opens the browser.
+- **macOS** — installs a tiny `Protoboard.app` bundle into `~/Applications/` declaring the `xyz.protoboard.file` UTI; `iconutil` assembles `.icns` from the bundled PNGs; LaunchServices picks it up via `lsregister`. If `duti` is installed, also sets as the default handler.
+- **Linux** — installs an XDG MIME definition, a `.desktop` entry, and mimetype icons via `xdg-icon-resource`. `xdg-mime default` makes it the default handler.
+
+The `.protoboard` format itself doesn't change — it's still plain JSON with a custom extension.
+
+## For maintainers
+
+```sh
+pnpm install
+pnpm run generate-icons         # rebuilds .ico + PNGs from assets/PB Logo N-200.svg
+```
+
+Generated icons (`assets/ProtoboardFile.ico`, `assets/icons/*.png`) are checked into the repo so install-time has no native build step. `.icns` is assembled on the user's mac at install time via Apple's `iconutil`, so it doesn't need to be checked in.
+
+### Publishing
+
+Tag a version and push:
+
+```sh
+git tag v0.1.0 && git push origin v0.1.0
+```
+
+The `Publish to npm` workflow uses the repo's `NPM_TOKEN` secret to publish to `@deltaroboticsinc/protoboard` on npmjs.com. First-time setup:
+
+1. NPM org `deltaroboticsinc` already exists.
+2. Generate an automation token at npmjs.com and add it as `NPM_TOKEN` in this repo's GitHub secrets.
+
+### Repo layout
+
+```
+assets/                   # SVG source + generated icons (committed)
+installers/
+  windows/                # install.ps1, uninstall.ps1, Open-Protoboard.ps1
+  macos/                  # install.sh, uninstall.sh, Protoboard.app/
+  linux/                  # install.sh, uninstall.sh, .xml, .desktop, launcher
+scripts/generate-icons.mjs
+cli.js                    # the published bin: detects OS and dispatches
+```
+
+## Troubleshooting
+
+- **Windows: icon doesn't update in Explorer.** Sign out/in, or run `ie4uinit.exe -show`. The installer triggers `SHChangeNotify` but Explorer occasionally caches aggressively.
+- **macOS: Finder still shows the JSON icon.** Right-click any `.protoboard` file → Get Info → Open with → Protoboard → Change All. Or install `duti` (`brew install duti`) and re-run the installer.
+- **Linux: handler doesn't open.** Confirm `~/.local/bin` is on `PATH`, or check `xdg-mime query default application/x-protoboard+json` returns `protoboard-open.desktop`.

package/assets/PB Logo N-200.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="500" zoomAndPan="magnify" viewBox="0 0 375 374.999991" height="500" preserveAspectRatio="xMidYMid meet" version="1.0"><defs><g/><clipPath id="9012e781b9"><rect x="0" width="303" y="0" height="375"/></clipPath></defs><g transform="matrix(1, 0, 0, 1, 36, 0)"><g clip-path="url(#9012e781b9)"><g fill="#e5e5e5" fill-opacity="1"><g transform="translate(0.238764, 349.173976)"><g><path d="M 93.671875 -137.90625 L 204.75 -249 C 206 -250.25 206.625 -251.816406 206.625 -253.703125 C 206.625 -255.585938 206 -257.15625 204.75 -258.40625 L 180.75 -281.9375 C 177.601562 -285.082031 173.679688 -286.65625 168.984375 -286.65625 L 132.734375 -286.65625 C 128.023438 -286.65625 124.101562 -285.082031 120.96875 -281.9375 L 93.671875 -254.640625 C 90.523438 -251.503906 88.953125 -247.582031 88.953125 -242.875 L 88.953125 -140.265625 C 88.953125 -137.753906 89.582031 -136.5 90.84375 -136.5 C 91.78125 -136.5 92.722656 -136.96875 93.671875 -137.90625 Z M 132.734375 -42.828125 L 168.984375 -42.828125 C 173.679688 -42.828125 177.601562 -44.398438 180.75 -47.546875 L 208.046875 -74.84375 C 211.179688 -77.976562 212.75 -81.898438 212.75 -86.609375 L 212.75 -189.21875 C 212.75 -191.726562 212.125 -192.984375 210.875 -192.984375 C 209.925781 -192.984375 208.984375 -192.507812 208.046875 -191.5625 L 96.96875 -80.484375 C 95.394531 -78.921875 94.609375 -77.351562 94.609375 -75.78125 C 94.609375 -74.207031 95.394531 -72.640625 96.96875 -71.078125 L 120.96875 -47.546875 C 124.101562 -44.398438 128.023438 -42.828125 132.734375 -42.828125 Z M 52.25 -273.9375 L 101.671875 -322.890625 C 105.429688 -327.285156 110.453125 -329.484375 116.734375 -329.484375 L 184.984375 -329.484375 C 190.941406 -329.484375 195.960938 -327.441406 200.046875 -323.359375 L 249 -273.9375 C 253.382812 -270.175781 255.578125 -265.15625 255.578125 -258.875 L 255.578125 -70.609375 C 255.578125 -64.640625 253.382812 -59.460938 249 -55.078125 L 200.046875 -6.125 C 195.960938 -2.039062 190.941406 0 184.984375 0 L 116.734375 0 C 110.453125 0 105.429688 -2.195312 101.671875 -6.59375 L 52.25 -55.546875 C 48.164062 -59.617188 46.125 -64.640625 46.125 -70.609375 L 46.125 -258.875 C 46.125 -264.84375 48.164062 -269.863281 52.25 -273.9375 Z M 52.25 -273.9375 "/></g></g></g></g></g></svg>

package/cli.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+const { spawn } = require('node:child_process');
+const path = require('node:path');
+const fs = require('node:fs');
+
+const VALID = new Set(['install', 'uninstall']);
+const HELP = `@deltaroboticsinc/protoboard
+
+Register the .protoboard file type with its logo and a double-click
+handler that opens the board in your default browser.
+
+Usage:
+  npx @deltaroboticsinc/protoboard <command>
+
+Commands:
+  install      Register .protoboard icon and open handler for the current user.
+  uninstall    Remove the registration.
+  --help       Show this message.
+  --version    Print the package version.
+
+Per-user install; no admin/root required.`;
+
+function pkgVersion() {
+  return require('./package.json').version;
+}
+
+function pickInstaller(cmd) {
+  const root = __dirname;
+  if (process.platform === 'win32') {
+    const script = path.join(root, 'installers', 'windows', cmd === 'install' ? 'install.ps1' : 'uninstall.ps1');
+    return {
+      exe: 'powershell.exe',
+      args: ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', script],
+    };
+  }
+  if (process.platform === 'darwin') {
+    const script = path.join(root, 'installers', 'macos', cmd === 'install' ? 'install.sh' : 'uninstall.sh');
+    return { exe: 'bash', args: [script] };
+  }
+  if (process.platform === 'linux') {
+    const script = path.join(root, 'installers', 'linux', cmd === 'install' ? 'install.sh' : 'uninstall.sh');
+    return { exe: 'bash', args: [script] };
+  }
+  return null;
+}
+
+function main() {
+  const arg = process.argv[2];
+  if (!arg || arg === '--help' || arg === '-h' || arg === 'help') {
+    console.log(HELP);
+    process.exit(0);
+  }
+  if (arg === '--version' || arg === '-v') {
+    console.log(pkgVersion());
+    process.exit(0);
+  }
+  if (!VALID.has(arg)) {
+    console.error(`Unknown command: ${arg}\n\n${HELP}`);
+    process.exit(2);
+  }
+  const picked = pickInstaller(arg);
+  if (!picked) {
+    console.error(`Unsupported platform: ${process.platform}. Supported: win32, darwin, linux.`);
+    process.exit(2);
+  }
+  if (!fs.existsSync(picked.args[picked.args.length - 1])) {
+    console.error(`Installer script missing: ${picked.args[picked.args.length - 1]}`);
+    process.exit(2);
+  }
+  const child = spawn(picked.exe, picked.args, { stdio: 'inherit' });
+  child.on('exit', (code) => process.exit(code ?? 1));
+  child.on('error', (err) => {
+    console.error(`Failed to launch installer: ${err.message}`);
+    process.exit(1);
+  });
+}
+
+main();

package/installers/linux/install.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# Register the .protoboard file type for the current user on Linux.
+# Per-user XDG paths; no sudo. Uses shared-mime-info + .desktop + xdg-icon-resource.
+
+set -euo pipefail
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+repo_root="$(cd "$script_dir/../.." && pwd)"
+icons_src="$repo_root/assets/icons"
+
+if [[ ! -f "$icons_src/256.png" ]]; then
+  echo "Missing PNGs in $icons_src. Run 'pnpm run generate-icons' first." >&2
+  exit 1
+fi
+
+mime_dir="$HOME/.local/share/mime/packages"
+apps_dir="$HOME/.local/share/applications"
+bin_dir="$HOME/.local/bin"
+
+mkdir -p "$mime_dir" "$apps_dir" "$bin_dir"
+
+# 1. MIME definition (links .protoboard glob to application/x-protoboard+json).
+cp "$script_dir/protoboard.xml" "$mime_dir/protoboard.xml"
+
+# 2. .desktop entry pointing at protoboard-open.
+cp "$script_dir/protoboard-open.desktop" "$apps_dir/protoboard-open.desktop"
+
+# 3. Launcher script.
+cp "$script_dir/protoboard-open" "$bin_dir/protoboard-open"
+chmod +x "$bin_dir/protoboard-open"
+
+# 4. Install mimetype icons at each size.
+for size in 16 32 48 64 128 256 512; do
+  png="$icons_src/$size.png"
+  if [[ -f "$png" ]]; then
+    xdg-icon-resource install --noupdate --context mimetypes --size "$size" "$png" application-x-protoboard+json
+  fi
+done
+xdg-icon-resource forceupdate
+
+# 5. Refresh MIME and desktop databases.
+update-mime-database "$HOME/.local/share/mime"
+update-desktop-database "$apps_dir" 2>/dev/null || true
+xdg-mime default protoboard-open.desktop application/x-protoboard+json
+
+case ":$PATH:" in
+  *":$bin_dir:"*) ;;
+  *) echo "Note: $bin_dir is not on PATH. The .desktop entry uses an absolute path so the handler will still fire, but you may want to add it for terminal use." ;;
+esac
+
+echo "Protoboard file association installed."
+echo "  Handler: $bin_dir/protoboard-open"
+echo "  MIME:    application/x-protoboard+json (glob *.protoboard)"

package/installers/linux/protoboard-open

@@ -0,0 +1,37 @@
+#!/bin/bash
+# Launcher invoked when a .protoboard file is opened on Linux.
+# Builds https://alpha.protoboard.xyz/board/<userId>/<boardId> when both
+# ids are present; otherwise falls back to https://alpha.protoboard.xyz/.
+
+set -u
+
+APP_ROOT="https://alpha.protoboard.xyz"
+
+file="${1:-}"
+if [[ -z "$file" || ! -f "$file" ]]; then
+  xdg-open "$APP_ROOT" >/dev/null 2>&1 &
+  exit 0
+fi
+
+read -r board_id user_id <<EOF
+$(python3 - "$file" <<'PY' 2>/dev/null || true
+import json, sys
+try:
+    with open(sys.argv[1], "r", encoding="utf-8") as fh:
+        d = json.load(fh)
+    board = d.get("board") or {}
+    md = board.get("metadata") or {}
+    bid = md.get("id") or ""
+    uid = md.get("userId") or board.get("userId") or ""
+    print(bid, uid)
+except Exception:
+    print("", "")
+PY
+)
+EOF
+
+if [[ -n "${board_id:-}" && -n "${user_id:-}" ]]; then
+  xdg-open "$APP_ROOT/board/$user_id/$board_id" >/dev/null 2>&1 &
+else
+  xdg-open "$APP_ROOT" >/dev/null 2>&1 &
+fi

package/installers/linux/protoboard-open.desktop

@@ -0,0 +1,10 @@
+[Desktop Entry]
+Type=Application
+Name=Protoboard
+Comment=Open Protoboard files in the browser
+Exec=protoboard-open %f
+Terminal=false
+NoDisplay=true
+MimeType=application/x-protoboard+json;
+Icon=application-x-protoboard+json
+Categories=Development;Engineering;

package/installers/linux/protoboard.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<mime-info xmlns="http://www.freedesktop.org/standards/shared-mime-info">
+  <mime-type type="application/x-protoboard+json">
+    <comment>Protoboard File</comment>
+    <sub-class-of type="application/json"/>
+    <glob pattern="*.protoboard"/>
+    <icon name="application-x-protoboard+json"/>
+  </mime-type>
+</mime-info>

package/installers/linux/uninstall.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+# Remove the .protoboard registration for the current user on Linux.
+
+set -u
+
+mime_file="$HOME/.local/share/mime/packages/protoboard.xml"
+desktop_file="$HOME/.local/share/applications/protoboard-open.desktop"
+bin_file="$HOME/.local/bin/protoboard-open"
+
+[[ -f "$mime_file"    ]] && rm -f "$mime_file"
+[[ -f "$desktop_file" ]] && rm -f "$desktop_file"
+[[ -f "$bin_file"     ]] && rm -f "$bin_file"
+
+for size in 16 32 48 64 128 256 512; do
+  xdg-icon-resource uninstall --noupdate --context mimetypes --size "$size" application-x-protoboard+json 2>/dev/null || true
+done
+xdg-icon-resource forceupdate 2>/dev/null || true
+
+update-mime-database "$HOME/.local/share/mime" 2>/dev/null || true
+update-desktop-database "$HOME/.local/share/applications" 2>/dev/null || true
+
+echo "Protoboard file association removed."

package/installers/macos/Protoboard.app/Contents/Info.plist

@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleIdentifier</key>
+  <string>xyz.protoboard.opener</string>
+  <key>CFBundleName</key>
+  <string>Protoboard</string>
+  <key>CFBundleDisplayName</key>
+  <string>Protoboard</string>
+  <key>CFBundleVersion</key>
+  <string>0.1.0</string>
+  <key>CFBundleShortVersionString</key>
+  <string>0.1.0</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+  <key>CFBundleSignature</key>
+  <string>????</string>
+  <key>CFBundleExecutable</key>
+  <string>protoboard-open</string>
+  <key>CFBundleIconFile</key>
+  <string>ProtoboardFile</string>
+  <key>LSMinimumSystemVersion</key>
+  <string>10.13</string>
+  <key>LSUIElement</key>
+  <true/>
+  <key>CFBundleDocumentTypes</key>
+  <array>
+    <dict>
+      <key>CFBundleTypeName</key>
+      <string>Protoboard File</string>
+      <key>CFBundleTypeRole</key>
+      <string>Viewer</string>
+      <key>CFBundleTypeIconFile</key>
+      <string>ProtoboardFile</string>
+      <key>LSItemContentTypes</key>
+      <array>
+        <string>xyz.protoboard.file</string>
+      </array>
+      <key>LSHandlerRank</key>
+      <string>Owner</string>
+    </dict>
+  </array>
+  <key>UTExportedTypeDeclarations</key>
+  <array>
+    <dict>
+      <key>UTTypeIdentifier</key>
+      <string>xyz.protoboard.file</string>
+      <key>UTTypeDescription</key>
+      <string>Protoboard File</string>
+      <key>UTTypeConformsTo</key>
+      <array>
+        <string>public.json</string>
+        <string>public.data</string>
+      </array>
+      <key>UTTypeIconFile</key>
+      <string>ProtoboardFile</string>
+      <key>UTTypeTagSpecification</key>
+      <dict>
+        <key>public.filename-extension</key>
+        <array>
+          <string>protoboard</string>
+        </array>
+        <key>public.mime-type</key>
+        <array>
+          <string>application/x-protoboard+json</string>
+        </array>
+      </dict>
+    </dict>
+  </array>
+</dict>
+</plist>

package/installers/macos/Protoboard.app/Contents/MacOS/protoboard-open

@@ -0,0 +1,37 @@
+#!/bin/bash
+# Launcher invoked by LaunchServices when a .protoboard file is opened.
+# Builds https://alpha.protoboard.xyz/board/<userId>/<boardId> when both
+# ids are present; otherwise falls back to https://alpha.protoboard.xyz/.
+
+set -u
+
+APP_ROOT="https://alpha.protoboard.xyz"
+
+file="${1:-}"
+if [[ -z "$file" || ! -f "$file" ]]; then
+  open "$APP_ROOT"
+  exit 0
+fi
+
+read -r board_id user_id <<EOF
+$(python3 - "$file" <<'PY' 2>/dev/null || true
+import json, sys
+try:
+    with open(sys.argv[1], "r", encoding="utf-8") as fh:
+        d = json.load(fh)
+    board = d.get("board") or {}
+    md = board.get("metadata") or {}
+    bid = md.get("id") or ""
+    uid = md.get("userId") or board.get("userId") or ""
+    print(bid, uid)
+except Exception:
+    print("", "")
+PY
+)
+EOF
+
+if [[ -n "${board_id:-}" && -n "${user_id:-}" ]]; then
+  open "$APP_ROOT/board/$user_id/$board_id"
+else
+  open "$APP_ROOT"
+fi

package/installers/macos/install.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+# Install the Protoboard.app bundle into ~/Applications and register the
+# .protoboard UTI + icon with LaunchServices. Per-user; no sudo.
+#
+# The .icns icon is assembled here (not pre-built) using Apple's native
+# iconutil, so the repo doesn't need to ship a binary .icns blob.
+
+set -euo pipefail
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+repo_root="$(cd "$script_dir/../.." && pwd)"
+src_app="$script_dir/Protoboard.app"
+dst_app="$HOME/Applications/Protoboard.app"
+
+if [[ ! -d "$src_app" ]]; then
+  echo "Missing app bundle: $src_app" >&2
+  exit 1
+fi
+
+# 1. Build ProtoboardFile.icns from the PNGs in assets/icons/.
+icons_src="$repo_root/assets/icons"
+if [[ ! -f "$icons_src/512.png" ]]; then
+  echo "Missing PNGs in $icons_src. Run 'pnpm run generate-icons' first." >&2
+  exit 1
+fi
+tmp_iconset="$(mktemp -d)/ProtoboardFile.iconset"
+mkdir -p "$tmp_iconset"
+cp "$icons_src/16.png"   "$tmp_iconset/icon_16x16.png"
+cp "$icons_src/32.png"   "$tmp_iconset/icon_16x16@2x.png"
+cp "$icons_src/32.png"   "$tmp_iconset/icon_32x32.png"
+cp "$icons_src/64.png"   "$tmp_iconset/icon_32x32@2x.png"
+cp "$icons_src/128.png"  "$tmp_iconset/icon_128x128.png"
+cp "$icons_src/256.png"  "$tmp_iconset/icon_128x128@2x.png"
+cp "$icons_src/256.png"  "$tmp_iconset/icon_256x256.png"
+cp "$icons_src/512.png"  "$tmp_iconset/icon_256x256@2x.png"
+cp "$icons_src/512.png"  "$tmp_iconset/icon_512x512.png"
+if [[ -f "$icons_src/1024.png" ]]; then
+  cp "$icons_src/1024.png" "$tmp_iconset/icon_512x512@2x.png"
+fi
+icns_out="$src_app/Contents/Resources/ProtoboardFile.icns"
+mkdir -p "$(dirname "$icns_out")"
+iconutil -c icns "$tmp_iconset" -o "$icns_out"
+rm -rf "$(dirname "$tmp_iconset")"
+
+# 2. Make the launcher executable and copy the bundle into ~/Applications.
+chmod +x "$src_app/Contents/MacOS/protoboard-open"
+mkdir -p "$HOME/Applications"
+rm -rf "$dst_app"
+cp -R "$src_app" "$dst_app"
+
+# 3. Register with LaunchServices so the UTI and icon are picked up.
+lsregister="/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister"
+"$lsregister" -f "$dst_app"
+
+# 4. Try to set as default handler. duti is optional.
+if command -v duti >/dev/null 2>&1; then
+  duti -s xyz.protoboard.file all || true
+fi
+
+# 5. Nudge Finder to refresh icon cache.
+killall Finder 2>/dev/null || true
+
+echo "Protoboard file association installed."
+echo "  App:   $dst_app"
+echo "  UTI:   xyz.protoboard.file"
+echo
+echo "If Finder still shows the default JSON icon: right-click any .protoboard file"
+echo "→ Get Info → Open with → Protoboard → Change All. Or install 'duti' (brew install duti)"
+echo "and re-run this installer."

package/installers/macos/uninstall.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Remove the Protoboard.app bundle and unregister the UTI.
+
+set -u
+
+dst_app="$HOME/Applications/Protoboard.app"
+lsregister="/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister"
+
+if [[ -d "$dst_app" ]]; then
+  "$lsregister" -u "$dst_app" 2>/dev/null || true
+  rm -rf "$dst_app"
+fi
+
+killall Finder 2>/dev/null || true
+echo "Protoboard file association removed."

package/installers/windows/Open-Protoboard.ps1

@@ -0,0 +1,38 @@
+# Launcher invoked by Explorer when a .protoboard file is double-clicked.
+# Builds https://alpha.protoboard.xyz/board/<userId>/<boardId> when both
+# ids are present; otherwise falls back to https://alpha.protoboard.xyz/.
+
+param([Parameter(Mandatory = $true)][string]$Path)
+
+$AppRoot = 'https://alpha.protoboard.xyz'
+
+function Open-Url([string]$Url) {
+  Start-Process $Url | Out-Null
+}
+
+try {
+  if (-not (Test-Path -LiteralPath $Path)) {
+    Open-Url $AppRoot
+    return
+  }
+  $json = Get-Content -LiteralPath $Path -Raw -Encoding UTF8 | ConvertFrom-Json
+
+  $boardId = $null
+  $userId  = $null
+  if ($json.board) {
+    if ($json.board.metadata) {
+      $boardId = $json.board.metadata.id
+      if (-not $userId) { $userId = $json.board.metadata.userId }
+    }
+    if (-not $userId) { $userId = $json.board.userId }
+  }
+
+  if ($boardId -and $userId) {
+    Open-Url "$AppRoot/board/$userId/$boardId"
+  } else {
+    Open-Url $AppRoot
+  }
+}
+catch {
+  Open-Url $AppRoot
+}

package/installers/windows/install.ps1

@@ -0,0 +1,85 @@
+# Register the .protoboard file type for the current user.
+# - Per-user HKCU registry (no admin required)
+# - Icon: ProtoboardFile.ico copied to %LOCALAPPDATA%\Protoboard\
+# - Open handler: Open-Protoboard.ps1 reads board id from the JSON
+#   and launches https://alpha.protoboard.xyz/open?boardId=...
+
+$ErrorActionPreference = 'Stop'
+
+$installDir = Join-Path $env:LOCALAPPDATA 'Protoboard'
+$scriptDir  = $PSScriptRoot
+$repoRoot   = Resolve-Path (Join-Path $scriptDir '..\..')
+$icoSource  = Join-Path $repoRoot 'assets\ProtoboardFile.ico'
+$launcherSource = Join-Path $scriptDir 'Open-Protoboard.ps1'
+
+if (-not (Test-Path $icoSource))     { throw "Missing icon: $icoSource. Run 'pnpm run generate-icons' first." }
+if (-not (Test-Path $launcherSource)) { throw "Missing launcher: $launcherSource" }
+
+New-Item -ItemType Directory -Path $installDir -Force | Out-Null
+Copy-Item $icoSource     (Join-Path $installDir 'ProtoboardFile.ico') -Force
+Copy-Item $launcherSource (Join-Path $installDir 'Open-Protoboard.ps1') -Force
+
+$icoPath      = Join-Path $installDir 'ProtoboardFile.ico'
+$launcherPath = Join-Path $installDir 'Open-Protoboard.ps1'
+
+$extKey   = 'HKCU:\Software\Classes\.protoboard'
+$progKey  = 'HKCU:\Software\Classes\Protoboard.File'
+$iconKey  = Join-Path $progKey 'DefaultIcon'
+$shellKey = Join-Path $progKey 'shell\open\command'
+
+New-Item -Path $extKey -Force | Out-Null
+New-ItemProperty -Path $extKey -Name '(default)'   -Value 'Protoboard.File'              -PropertyType String -Force | Out-Null
+New-ItemProperty -Path $extKey -Name 'Content Type'  -Value 'application/x-protoboard+json' -PropertyType String -Force | Out-Null
+New-ItemProperty -Path $extKey -Name 'PerceivedType' -Value 'text'                        -PropertyType String -Force | Out-Null
+
+New-Item -Path $progKey -Force | Out-Null
+New-ItemProperty -Path $progKey -Name '(default)'      -Value 'Protoboard File'           -PropertyType String -Force | Out-Null
+New-ItemProperty -Path $progKey -Name 'FriendlyTypeName' -Value 'Protoboard File'         -PropertyType String -Force | Out-Null
+
+New-Item -Path $iconKey -Force | Out-Null
+New-ItemProperty -Path $iconKey -Name '(default)' -Value "`"$icoPath`",0" -PropertyType String -Force | Out-Null
+
+New-Item -Path $shellKey -Force | Out-Null
+$openCmd = "powershell.exe -NoProfile -ExecutionPolicy Bypass -File `"$launcherPath`" `"%1`""
+New-ItemProperty -Path $shellKey -Name '(default)' -Value $openCmd -PropertyType String -Force | Out-Null
+
+# If the user has ever right-clicked → Open with on a .protoboard file,
+# Windows wrote a UserChoice override under FileExts that hides our icon.
+# Clear it so DefaultIcon wins. (Re-set as Open-with is one-click to recover.)
+$fileExts = 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\FileExts\.protoboard'
+if (Test-Path $fileExts) {
+  Remove-Item -Path $fileExts -Recurse -Force -ErrorAction SilentlyContinue
+}
+
+# Wipe the per-user icon cache so Explorer re-reads DefaultIcon.
+$explorerWasRunning = $false
+$explorer = Get-Process explorer -ErrorAction SilentlyContinue
+if ($explorer) {
+  $explorerWasRunning = $true
+  Stop-Process -Name explorer -Force -ErrorAction SilentlyContinue
+  Start-Sleep -Milliseconds 600
+}
+$cacheDir = Join-Path $env:LOCALAPPDATA 'Microsoft\Windows\Explorer'
+if (Test-Path $cacheDir) {
+  Get-ChildItem -Path $cacheDir -Filter 'iconcache_*.db' -Force -ErrorAction SilentlyContinue |
+    Remove-Item -Force -ErrorAction SilentlyContinue
+  Get-ChildItem -Path $cacheDir -Filter 'thumbcache_*.db' -Force -ErrorAction SilentlyContinue |
+    Remove-Item -Force -ErrorAction SilentlyContinue
+}
+$legacyCache = Join-Path $env:LOCALAPPDATA 'IconCache.db'
+if (Test-Path $legacyCache) { Remove-Item -Path $legacyCache -Force -ErrorAction SilentlyContinue }
+
+if ($explorerWasRunning) { Start-Process explorer.exe | Out-Null }
+
+# Force Explorer to pick up the new icon/handler immediately.
+Add-Type -Namespace Win32 -Name Shell32 -MemberDefinition @'
+[System.Runtime.InteropServices.DllImport("shell32.dll")]
+public static extern void SHChangeNotify(int wEventId, int uFlags, System.IntPtr dwItem1, System.IntPtr dwItem2);
+'@ | Out-Null
+[Win32.Shell32]::SHChangeNotify(0x08000000, 0, [System.IntPtr]::Zero, [System.IntPtr]::Zero)
+
+Write-Host "Protoboard file association installed." -ForegroundColor Green
+Write-Host "  Icon:    $icoPath"
+Write-Host "  Handler: $launcherPath"
+Write-Host ""
+Write-Host "Save a .protoboard file anywhere to see the icon. Double-click opens the board in your browser."

package/installers/windows/uninstall.ps1

@@ -0,0 +1,19 @@
+# Remove the .protoboard file-type registration for the current user.
+
+$ErrorActionPreference = 'Continue'
+
+$installDir = Join-Path $env:LOCALAPPDATA 'Protoboard'
+$extKey  = 'HKCU:\Software\Classes\.protoboard'
+$progKey = 'HKCU:\Software\Classes\Protoboard.File'
+
+if (Test-Path $extKey)  { Remove-Item -Path $extKey  -Recurse -Force }
+if (Test-Path $progKey) { Remove-Item -Path $progKey -Recurse -Force }
+if (Test-Path $installDir) { Remove-Item -Path $installDir -Recurse -Force }
+
+Add-Type -Namespace Win32 -Name Shell32 -MemberDefinition @'
+[System.Runtime.InteropServices.DllImport("shell32.dll")]
+public static extern void SHChangeNotify(int wEventId, int uFlags, System.IntPtr dwItem1, System.IntPtr dwItem2);
+'@ | Out-Null
+[Win32.Shell32]::SHChangeNotify(0x08000000, 0, [System.IntPtr]::Zero, [System.IntPtr]::Zero)
+
+Write-Host "Protoboard file association removed." -ForegroundColor Green

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@deltaroboticsinc/protoboard",
+  "version": "0.1.0",
+  "description": "Register the .protoboard file type with its logo and a double-click handler across Windows, macOS, and Linux.",
+  "license": "UNLICENSED",
+  "author": "Delta Robotics Inc",
+  "homepage": "https://github.com/Delta-Robotics-Inc/protoboard-desktop",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Delta-Robotics-Inc/protoboard-desktop.git"
+  },
+  "bin": {
+    "protoboard": "./cli.js"
+  },
+  "main": "cli.js",
+  "files": [
+    "cli.js",
+    "assets/",
+    "installers/"
+  ],
+  "devDependencies": {
+    "png-to-ico": "^2.1.8",
+    "sharp": "^0.34.1"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "keywords": [
+    "protoboard",
+    "file-association",
+    "file-icon",
+    "windows",
+    "macos",
+    "linux"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "generate-icons": "node scripts/generate-icons.mjs"
+  }
+}