feat: ES-162 add welcome screen to select scan root

app.go

@@ -194,6 +194,10 @@ func (a *App) GetScanRoot() (string, error) {
 	return a.cfg.GetScanRoot(), nil
 }
 
+func (a *App) GetRecentScanRoots() ([]string, error) {
+	return a.cfg.GetRecentScanRoots(), nil
+}
+
 func (a *App) GetResultFilePath() (string, error) {
 	return a.cfg.GetResultFilePath(), nil
 }

frontend/src/components/WelcomeScreen.tsx

@@ -0,0 +1,138 @@
+// SPDX-License-Identifier: MIT
+/*
+ * Copyright (C) 2018-2025 SCANOSS.COM
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * 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.
+ */
+
+import { FolderOpen, Search } from 'lucide-react';
+import { useEffect, useState } from 'react';
+
+import { withErrorHandling } from '@/lib/errors';
+import useConfigStore from '@/stores/useConfigStore';
+
+import { SelectDirectory } from '../../wailsjs/go/main/App';
+import { entities } from '../../wailsjs/go/models';
+import { EventsOn } from '../../wailsjs/runtime/runtime';
+import ScanDialog from './ScanDialog';
+import { Button } from './ui/button';
+import { Card, CardContent, CardHeader, CardTitle } from './ui/card';
+import { toast } from './ui/use-toast';
+
+export default function WelcomeScreen() {
+  const setScanRoot = useConfigStore((state) => state.setScanRoot);
+  const recentScanRoots = useConfigStore((state) => state.recentScanRoots);
+  const [scanModal, setScanModal] = useState(false);
+
+  const handleSelectScanRoot = withErrorHandling({
+    asyncFn: async () => {
+      const selectedDir = await SelectDirectory();
+      if (selectedDir) {
+        await setScanRoot(selectedDir);
+      }
+    },
+    onError: () => {
+      toast({
+        variant: 'destructive',
+        title: 'Error',
+        description: 'An error occurred while selecting the scan root. Please try again.',
+      });
+    },
+  });
+
+  const handleSelectRecentFolder = withErrorHandling({
+    asyncFn: async (path: string) => {
+      await setScanRoot(path);
+    },
+    onError: () => {
+      toast({
+        variant: 'destructive',
+        title: 'Error',
+        description: 'An error occurred while selecting the recent folder. Please try again.',
+      });
+    },
+  });
+
+  const handleCloseScanModal = () => setScanModal(false);
+  const handleShowScanModal = () => setScanModal(true);
+
+  useEffect(() => {
+    const unsubScanWithOptions = EventsOn(entities.Action.ScanWithOptions, () => {
+      handleShowScanModal();
+    });
+
+    return () => {
+      unsubScanWithOptions();
+    };
+  }, []);
+
+  return (
+    <div className="flex h-screen w-screen flex-col items-center justify-center space-y-8 p-8">
+      <div className="space-y-2 text-center">
+        <h1 className="text-3xl font-semibold tracking-tight">SCANOSS Code Compare</h1>
+        <p className="text-lg text-muted-foreground">Select a folder to start</p>
+      </div>
+
+      <div className="grid w-full max-w-4xl gap-6">
+        <Card>
+          <CardHeader>
+            <CardTitle className="text-lg font-medium">Start</CardTitle>
+          </CardHeader>
+          <CardContent className="grid gap-4">
+            <Button variant="ghost" className="w-full justify-start gap-2 px-2" onClick={handleSelectScanRoot}>
+              <FolderOpen className="h-5 w-5" />
+              Open Folder...
+            </Button>
+            <Button variant="ghost" className="w-full justify-start gap-2 px-2" onClick={handleShowScanModal}>
+              <Search className="h-5 w-5" />
+              Run a new scan...
+            </Button>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardHeader>
+            <CardTitle className="text-lg font-medium">Recent</CardTitle>
+          </CardHeader>
+          <CardContent>
+            {recentScanRoots.length > 0 ? (
+              <div className="grid gap-2">
+                {recentScanRoots.map((path) => (
+                  <Button
+                    key={path}
+                    variant="ghost"
+                    className="w-full justify-start gap-2 px-2 text-sm"
+                    onClick={() => handleSelectRecentFolder(path)}
+                  >
+                    <FolderOpen className="h-4 w-4" />
+                    {path}
+                  </Button>
+                ))}
+              </div>
+            ) : (
+              <p className="text-sm text-muted-foreground">No recent folders</p>
+            )}
+          </CardContent>
+        </Card>
+      </div>
+
+      <ScanDialog open={scanModal} onOpenChange={handleCloseScanModal} />
+    </div>
+  );
+}

frontend/src/components/ui/card.tsx

@@ -0,0 +1,76 @@
+import * as React from "react"
+
+import { cn } from "@/lib/utils"
+
+const Card = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn(
+      "rounded-xl border bg-card text-card-foreground shadow",
+      className
+    )}
+    {...props}
+  />
+))
+Card.displayName = "Card"
+
+const CardHeader = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("flex flex-col space-y-1.5 p-6", className)}
+    {...props}
+  />
+))
+CardHeader.displayName = "CardHeader"
+
+const CardTitle = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("font-semibold leading-none tracking-tight", className)}
+    {...props}
+  />
+))
+CardTitle.displayName = "CardTitle"
+
+const CardDescription = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("text-sm text-muted-foreground", className)}
+    {...props}
+  />
+))
+CardDescription.displayName = "CardDescription"
+
+const CardContent = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div ref={ref} className={cn("p-6 pt-0", className)} {...props} />
+))
+CardContent.displayName = "CardContent"
+
+const CardFooter = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("flex items-center p-6 pt-0", className)}
+    {...props}
+  />
+))
+CardFooter.displayName = "CardFooter"
+
+export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent }

frontend/src/hooks/useResults.tsx

@@ -26,7 +26,8 @@ export const useResults = () => {
   };
 
   return {
-    ...queryResult,
+    data: queryResult.data,
+    isLoading: queryResult.isLoading,
     reset,
   };
 };

frontend/src/lib/utils.ts

@@ -48,3 +48,14 @@ export function truncatePath(path: string, maxLength: number = 30) {
   const last = parts[parts.length - 1];
   return `${first}/.../${last}`;
 }
+
+export const isDefaultPath = (path: string, platform: string | undefined) => {
+  switch (platform) {
+    case 'darwin':
+      return path === '/' || path === '/Users';
+    case 'windows':
+      return path === 'C:\\' || path === '';
+    default:
+      return path === '/' || path === '/home';
+  }
+};

frontend/src/routes/root.tsx

@@ -29,11 +29,17 @@ import ScanDialog from '@/components/ScanDialog';
 import Sidebar from '@/components/Sidebar';
 import StatusBar from '@/components/StatusBar';
 import { ResizableHandle, ResizablePanel, ResizablePanelGroup } from '@/components/ui/resizable';
+import WelcomeScreen from '@/components/WelcomeScreen';
+import useEnvironment from '@/hooks/useEnvironment';
+import { isDefaultPath } from '@/lib/utils';
+import useConfigStore from '@/stores/useConfigStore';
 
 import { entities } from '../../wailsjs/go/models';
 import { EventsOn } from '../../wailsjs/runtime/runtime';
 
 export default function Root() {
+  const { environment } = useEnvironment();
+  const scanRoot = useConfigStore((state) => state.scanRoot);
   const [showKeyboardShortcuts, setShowKeyboardShortcuts] = useState(false);
   const [scanModal, setScanModal] = useState(false);
   const handleCloseScanModal = () => {
@@ -45,15 +51,23 @@ export default function Root() {
   };
 
   useEffect(() => {
-    // Register event listeners
-    EventsOn(entities.Action.ShowKeyboardShortcutsModal, () => {
+    const unsubShowKeyboardShortcuts = EventsOn(entities.Action.ShowKeyboardShortcutsModal, () => {
       setShowKeyboardShortcuts(true);
     });
-    EventsOn(entities.Action.ScanWithOptions, () => {
+    const unsubScanWithOptions = EventsOn(entities.Action.ScanWithOptions, () => {
       handleShowScanModal();
     });
+
+    return () => {
+      unsubShowKeyboardShortcuts();
+      unsubScanWithOptions();
+    };
   }, []);
 
+  if (isDefaultPath(scanRoot, environment?.platform)) {
+    return <WelcomeScreen />;
+  }
+
   return (
     <div className="flex h-screen w-full flex-col bg-background backdrop-blur-lg">
       <div className="min-h-0 flex-1">

frontend/src/stores/useConfigStore.ts

@@ -25,6 +25,7 @@ import { create } from 'zustand';
 import { devtools } from 'zustand/middleware';
 
 import {
+  GetRecentScanRoots,
   GetResultFilePath,
   GetScanRoot,
   GetScanSettingsFilePath,
@@ -37,6 +38,7 @@ interface ResultsState {
   scanRoot: string;
   resultsFile: string;
   settingsFile: string;
+  recentScanRoots: string[];
 }
 
 interface ResultsActions {
@@ -54,6 +56,7 @@ export default create<ConfigStore>()(
     scanRoot: '',
     resultsFile: '',
     settingsFile: '',
+    recentScanRoots: [],
 
     setScanRoot: async (scanRoot: string) => {
       await SetScanRoot(scanRoot);
@@ -72,7 +75,8 @@ export default create<ConfigStore>()(
       const scanRoot = await GetScanRoot();
       const resultsFile = await GetResultFilePath();
       const settingsFile = await GetScanSettingsFilePath();
-      set({ scanRoot, resultsFile, settingsFile });
+      const recentScanRoots = await GetRecentScanRoots();
+      set({ scanRoot, resultsFile, settingsFile, recentScanRoots });
     },
   }))
 );

frontend/src/style.css

@@ -93,3 +93,12 @@ body {
   width: 3px !important;
   margin-left: 5px;
 }
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}

frontend/wailsjs/go/main/App.d.ts

@@ -5,6 +5,8 @@ import {service} from '../models';
 
 export function BeforeClose(arg1:context.Context):Promise<boolean>;
 
+export function GetRecentScanRoots():Promise<Array<string>>;
+
 export function GetResultFilePath():Promise<string>;
 
 export function GetScanRoot():Promise<string>;

frontend/wailsjs/go/main/App.js

@@ -6,6 +6,10 @@ export function BeforeClose(arg1) {
   return window['go']['main']['App']['BeforeClose'](arg1);
 }
 
+export function GetRecentScanRoots() {
+  return window['go']['main']['App']['GetRecentScanRoots']();
+}
+
 export function GetResultFilePath() {
   return window['go']['main']['App']['GetResultFilePath']();
 }