feat: allow custom install and start commands (#892)

drizzle/0010_nappy_fat_cobra.sql

+ALTER TABLE `apps` ADD `install_command` text;--> statement-breakpoint
+ALTER TABLE `apps` ADD `start_command` text;

drizzle/meta/_journal.json

@@ -71,6 +71,13 @@
       "when": 1753473275674,
       "tag": "0009_previous_misty_knight",
       "breakpoints": true
+    },
+    {
+      "idx": 10,
+      "version": "6",
+      "when": 1755110011615,
+      "tag": "0010_nappy_fat_cobra",
+      "breakpoints": true
     }
   ]
 }
\ No newline at end of file

e2e-tests/import.spec.ts

 import path from "path";
 import { testSkipIfWindows } from "./helpers/test_helper";
+import { expect } from "@playwright/test";
 import * as eph from "electron-playwright-helpers";
 
 testSkipIfWindows("import app", async ({ po }) => {
@@ -43,3 +44,58 @@ testSkipIfWindows("import app with AI rules", async ({ po }) => {
   await po.snapshotServerDump();
   await po.snapshotMessages({ replaceDumpPath: true });
 });
+
+testSkipIfWindows("import app with custom commands", async ({ po }) => {
+  await po.setUp();
+  await po.page.getByRole("button", { name: "Import App" }).click();
+  await eph.stubDialog(po.electronApp, "showOpenDialog", {
+    filePaths: [path.join(__dirname, "fixtures", "import-app", "minimal")],
+  });
+  await po.page.getByRole("button", { name: "Select Folder" }).click();
+  await po.page
+    .getByRole("textbox", { name: "Enter new app name" })
+    .fill("minimal-imported-app");
+
+  await po.page.getByRole("button", { name: "Advanced options" }).click();
+
+  await po.page.getByPlaceholder("pnpm install").fill("");
+  await po.page.getByPlaceholder("pnpm dev").fill("npm start");
+  await expect(po.page.getByRole("button", { name: "Import" })).toBeDisabled();
+  await expect(
+    po.page.getByText("Both commands are required when customizing."),
+  ).toBeVisible();
+
+  await po.page.getByPlaceholder("pnpm install").fill("npm i");
+  await expect(po.page.getByRole("button", { name: "Import" })).toBeEnabled();
+  await expect(
+    po.page.getByText("Both commands are required when customizing."),
+  ).toHaveCount(0);
+
+  await po.page.getByRole("button", { name: "Import" }).click();
+});
+
+testSkipIfWindows(
+  "advanced options: both cleared are valid and use defaults",
+  async ({ po }) => {
+    await po.setUp();
+    await po.page.getByRole("button", { name: "Import App" }).click();
+    await eph.stubDialog(po.electronApp, "showOpenDialog", {
+      filePaths: [path.join(__dirname, "fixtures", "import-app", "minimal")],
+    });
+    await po.page.getByRole("button", { name: "Select Folder" }).click();
+
+    await po.page
+      .getByRole("textbox", { name: "Enter new app name" })
+      .fill("both-cleared");
+
+    await po.page.getByRole("button", { name: "Advanced options" }).click();
+    await po.page.getByPlaceholder("pnpm install").fill("");
+    await po.page.getByPlaceholder("pnpm dev").fill("");
+
+    await expect(po.page.getByRole("button", { name: "Import" })).toBeEnabled();
+
+    await po.page.getByRole("button", { name: "Import" }).click();
+
+    await po.snapshotPreview();
+  },
+);

e2e-tests/snapshots/import.spec.ts_advanced-options-both-cleared-are-valid-and-use-defaults-1.aria.yml

+- text: Minimal imported app
\ No newline at end of file

src/components/ImportAppDialog.tsx

@@ -27,6 +27,12 @@ import {
 import { selectedAppIdAtom } from "@/atoms/appAtoms";
 import { useSetAtom } from "jotai";
 import { useLoadApps } from "@/hooks/useLoadApps";
+import {
+  Accordion,
+  AccordionContent,
+  AccordionItem,
+  AccordionTrigger,
+} from "./ui/accordion";
 
 interface ImportAppDialogProps {
   isOpen: boolean;
@@ -39,6 +45,8 @@ export function ImportAppDialog({ isOpen, onClose }: ImportAppDialogProps) {
   const [customAppName, setCustomAppName] = useState<string>("");
   const [nameExists, setNameExists] = useState<boolean>(false);
   const [isCheckingName, setIsCheckingName] = useState<boolean>(false);
+  const [installCommand, setInstallCommand] = useState("pnpm install");
+  const [startCommand, setStartCommand] = useState("pnpm dev");
   const navigate = useNavigate();
   const { streamMessage } = useStreamChat({ hasChatId: false });
   const { refreshApps } = useLoadApps();
@@ -89,6 +97,8 @@ export function ImportAppDialog({ isOpen, onClose }: ImportAppDialogProps) {
       return IpcClient.getInstance().importApp({
         path: selectedPath,
         appName: customAppName,
+        installCommand: installCommand || undefined,
+        startCommand: startCommand || undefined,
       });
     },
     onSuccess: async (result) => {
@@ -128,6 +138,8 @@ export function ImportAppDialog({ isOpen, onClose }: ImportAppDialogProps) {
     setHasAiRules(null);
     setCustomAppName("");
     setNameExists(false);
+    setInstallCommand("pnpm install");
+    setStartCommand("pnpm dev");
   };
 
   const handleAppNameChange = async (
@@ -140,6 +152,10 @@ export function ImportAppDialog({ isOpen, onClose }: ImportAppDialogProps) {
     }
   };
 
+  const hasInstallCommand = installCommand.trim().length > 0;
+  const hasStartCommand = startCommand.trim().length > 0;
+  const commandsValid = hasInstallCommand === hasStartCommand;
+
   return (
     <Dialog open={isOpen} onOpenChange={onClose}>
       <DialogContent>
@@ -221,6 +237,41 @@ export function ImportAppDialog({ isOpen, onClose }: ImportAppDialogProps) {
                 </div>
               </div>
 
+              <Accordion type="single" collapsible>
+                <AccordionItem value="advanced-options">
+                  <AccordionTrigger className="text-sm hover:no-underline">
+                    Advanced options
+                  </AccordionTrigger>
+                  <AccordionContent className="space-y-4">
+                    <div className="grid gap-2">
+                      <Label className="text-sm ml-2 mb-2">
+                        Install command
+                      </Label>
+                      <Input
+                        value={installCommand}
+                        onChange={(e) => setInstallCommand(e.target.value)}
+                        placeholder="pnpm install"
+                        disabled={importAppMutation.isPending}
+                      />
+                    </div>
+                    <div className="grid gap-2">
+                      <Label className="text-sm ml-2 mb-2">Start command</Label>
+                      <Input
+                        value={startCommand}
+                        onChange={(e) => setStartCommand(e.target.value)}
+                        placeholder="pnpm dev"
+                        disabled={importAppMutation.isPending}
+                      />
+                    </div>
+                    {!commandsValid && (
+                      <p className="text-sm text-red-500">
+                        Both commands are required when customizing.
+                      </p>
+                    )}
+                  </AccordionContent>
+                </AccordionItem>
+              </Accordion>
+
               {hasAiRules === false && (
                 <Alert className="border-yellow-500/20 text-yellow-500 flex items-start gap-2">
                   <TooltipProvider>
@@ -264,7 +315,10 @@ export function ImportAppDialog({ isOpen, onClose }: ImportAppDialogProps) {
           <Button
             onClick={handleImport}
             disabled={
-              !selectedPath || importAppMutation.isPending || nameExists
+              !selectedPath ||
+              importAppMutation.isPending ||
+              nameExists ||
+              !commandsValid
             }
             className="min-w-[80px]"
           >

src/db/schema.ts

@@ -23,6 +23,8 @@ export const apps = sqliteTable("apps", {
   vercelProjectName: text("vercel_project_name"),
   vercelTeamId: text("vercel_team_id"),
   vercelDeploymentUrl: text("vercel_deployment_url"),
+  installCommand: text("install_command"),
+  startCommand: text("start_command"),
   chatContext: text("chat_context", { mode: "json" }),
 });
 

src/ipc/handlers/app_handlers.ts

@@ -83,17 +83,28 @@ async function executeApp({
   appId,
   event, // Keep event for local-node case
   isNeon,
+  installCommand,
+  startCommand,
 }: {
   appPath: string;
   appId: number;
   event: Electron.IpcMainInvokeEvent;
   isNeon: boolean;
+  installCommand?: string | null;
+  startCommand?: string | null;
 }): Promise<void> {
   if (proxyWorker) {
     proxyWorker.terminate();
     proxyWorker = null;
   }
-  await executeAppLocalNode({ appPath, appId, event, isNeon });
+  await executeAppLocalNode({
+    appPath,
+    appId,
+    event,
+    isNeon,
+    installCommand,
+    startCommand,
+  });
 }
 
 async function executeAppLocalNode({
@@ -101,22 +112,28 @@ async function executeAppLocalNode({
   appId,
   event,
   isNeon,
+  installCommand,
+  startCommand,
 }: {
   appPath: string;
   appId: number;
   event: Electron.IpcMainInvokeEvent;
   isNeon: boolean;
+  installCommand?: string | null;
+  startCommand?: string | null;
 }): Promise<void> {
-  const spawnedProcess = spawn(
-    "(pnpm install && pnpm run dev --port 32100) || (npm install --legacy-peer-deps && npm run dev -- --port 32100)",
-    [],
-    {
-      cwd: appPath,
-      shell: true,
-      stdio: "pipe", // Ensure stdio is piped so we can capture output/errors and detect close
-      detached: false, // Ensure child process is attached to the main process lifecycle unless explicitly backgrounded
-    },
-  );
+  const defaultCommand =
+    "(pnpm install && pnpm run dev --port 32100) || (npm install --legacy-peer-deps && npm run dev -- --port 32100)";
+  const hasCustomCommands = !!installCommand?.trim() && !!startCommand?.trim();
+  const command = hasCustomCommands
+    ? `${installCommand!.trim()} && ${startCommand!.trim()}`
+    : defaultCommand;
+  const spawnedProcess = spawn(command, [], {
+    cwd: appPath,
+    shell: true,
+    stdio: "pipe", // Ensure stdio is piped so we can capture output/errors and detect close
+    detached: false, // Ensure child process is attached to the main process lifecycle unless explicitly backgrounded
+  });
 
   // Check if process spawned correctly
   if (!spawnedProcess.pid) {
@@ -375,6 +392,8 @@ export function registerAppHandlers() {
           supabaseProjectId: null,
           githubOrg: null,
           githubRepo: null,
+          installCommand: originalApp.installCommand,
+          startCommand: originalApp.startCommand,
         })
         .returning();
 
@@ -511,6 +530,8 @@ export function registerAppHandlers() {
             appId,
             event,
             isNeon: !!app.neonProjectId,
+            installCommand: app.installCommand,
+            startCommand: app.startCommand,
           });
 
           return;
@@ -646,6 +667,8 @@ export function registerAppHandlers() {
             appId,
             event,
             isNeon: !!app.neonProjectId,
+            installCommand: app.installCommand,
+            startCommand: app.startCommand,
           }); // This will handle starting either mode
 
           return;

src/ipc/handlers/import_handlers.ts

@@ -69,7 +69,12 @@ export function registerImportHandlers() {
     "import-app",
     async (
       _,
-      { path: sourcePath, appName }: ImportAppParams,
+      {
+        path: sourcePath,
+        appName,
+        installCommand,
+        startCommand,
+      }: ImportAppParams,
     ): Promise<ImportAppResult> => {
       // Validate the source path exists
       try {
@@ -128,6 +133,8 @@ export function registerImportHandlers() {
           name: appName,
           // Use the name as the path for now
           path: appName,
+          installCommand: installCommand ?? null,
+          startCommand: startCommand ?? null,
         })
         .returning();
 

src/ipc/ipc_types.ts

@@ -96,6 +96,8 @@ export interface App {
   vercelProjectName: string | null;
   vercelTeamSlug: string | null;
   vercelDeploymentUrl: string | null;
+  installCommand: string | null;
+  startCommand: string | null;
 }
 
 export interface Version {
@@ -226,6 +228,8 @@ export interface ApproveProposalResult {
 export interface ImportAppParams {
   path: string;
   appName: string;
+  installCommand?: string;
+  startCommand?: string;
 }
 
 export interface CopyAppParams {