precompile native modules

Author: jonathanlab

README.md

@@ -33,6 +33,29 @@ pnpm run typecheck  # Type checking
 pnpm run lint       # Linting
 ```
 
+### Building Distributables
+
+To create production distributables (DMG, ZIP):
+
+```bash
+# Package the app
+pnpm package
+
+# Create distributables (DMG + ZIP)
+pnpm make
+```
+
+Output will be in:
+- `out/Array-darwin-arm64/Array.app` - Packaged app
+- `out/make/Array-*.dmg` - macOS installer
+- `out/make/zip/` - ZIP archives
+
+**Note:** Native modules for the DMG maker are automatically compiled via the `prePackage` hook. If you need to manually rebuild them, run:
+
+```bash
+pnpm build-native
+```
+
 ### Environment Variables
 
 You can set these environment variables instead of entering credentials in the app:

forge.config.ts

@@ -1,3 +1,5 @@
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
 import { MakerDMG } from "@electron-forge/maker-dmg";
 import { MakerZIP } from "@electron-forge/maker-zip";
 import { VitePlugin } from "@electron-forge/plugin-vite";
@@ -18,6 +20,20 @@ const config: ForgeConfig = {
     }),
     new MakerZIP({}, ["darwin", "linux", "win32"]),
   ],
+  hooks: {
+    prePackage: async () => {
+      // Build native modules for DMG maker on Node.js 22
+      const modules = ["macos-alias", "fs-xattr"];
+
+      for (const module of modules) {
+        const modulePath = `node_modules/${module}`;
+        if (existsSync(modulePath)) {
+          console.log(`Building native module: ${module}`);
+          execSync("npm install", { cwd: modulePath, stdio: "inherit" });
+        }
+      }
+    },
+  },
   plugins: [
     new VitePlugin({
       build: [

package.json

@@ -13,6 +13,7 @@
     "package": "electron-forge package",
     "make": "electron-forge make",
     "publish": "electron-forge publish",
+    "build-native": "bash scripts/build-native-modules.sh",
     "typecheck": "tsc -p tsconfig.node.json --noEmit && tsc -p tsconfig.web.json --noEmit",
     "lint": "biome check --write --unsafe",
     "format": "biome format --write",

scripts/build-native-modules.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+
+# Build native modules for DMG maker on Node.js 22
+# This script compiles macos-alias and fs-xattr native modules
+
+set -e
+
+echo "Building native modules for DMG maker..."
+
+# Compile macos-alias
+if [ -d "node_modules/macos-alias" ]; then
+  echo "Compiling macos-alias..."
+  cd node_modules/macos-alias
+  npm install
+  cd ../..
+  echo "✓ macos-alias compiled"
+else
+  echo "⚠ macos-alias not found, skipping"
+fi
+
+# Compile fs-xattr
+if [ -d "node_modules/fs-xattr" ]; then
+  echo "Compiling fs-xattr..."
+  cd node_modules/fs-xattr
+  npm install
+  cd ../..
+  echo "✓ fs-xattr compiled"
+else
+  echo "⚠ fs-xattr not found, skipping"
+fi
+
+echo "✓ Native modules built successfully"