feat(dashboard): add dashboard screen and reorganize app navigation

assets/icons/index.ts

@@ -18,6 +18,10 @@ import apacheIcebergLake from './apache-iceberg-lake.png';
 import deltaLake from './delta-lake.png';
 import apacheHudiLake from './apache-hudi-lake.png';
 import flow from './flow.svg';
+import analytics from './analytics.png';
+import datalakeCard from './datalake_card.png';
+import cloudSearch from './cloud-search.png';
+import dataMigration from './data-migration.png';
 
 export const icons = {
   settings,
@@ -40,4 +44,8 @@ export const icons = {
   deltaLake,
   apacheHudiLake,
   flow,
+  analytics,
+  datalakeCard,
+  cloudSearch,
+  dataMigration,
 };

e2e/fixtures/electron.fixture.ts

@@ -32,10 +32,10 @@ export type ElectronFixtures = {
   extraProjects: string[];
   /**
    * Mark the Quick Start tour as already seen before the renderer loads.
-   * The tour auto-opens ~700ms after the project selection screen mounts
-   * with zero projects and its full-screen overlay swallows every click, so
-   * tests that don't target it would otherwise race against it. Set to false
-   * in specs that test the tour itself.
+   * The tour auto-opens ~700ms after the Home screen (dashboard) mounts with
+   * zero projects and its full-screen overlay swallows every click, so tests
+   * that don't target it would otherwise race against it. Set to false in
+   * specs that test the tour itself.
    */
   skipQuickStartTour: boolean;
   /** The Electron application instance */

e2e/helpers/window.helper.ts

@@ -37,7 +37,28 @@ export const findStableWindow = async (
 };
 
 /**
- * Land on the project selection screen with setup skipped.
+ * Land on the Home screen (dashboard) with setup skipped. Home is the app's
+ * default route, so this simply waits for the workspace overview to mount.
+ */
+export const openHome = async (
+  electronApp: ElectronApplication,
+): Promise<Page> => {
+  const window = await findStableWindow(electronApp);
+  await window.waitForLoadState('domcontentloaded');
+
+  const appHelper = new AppHelper(electronApp, window);
+  await appHelper.skipSetupIfPresent();
+
+  await window.waitForSelector('[data-tour="tour-workspace-overview"]', {
+    timeout: 10000,
+  });
+  return window;
+};
+
+/**
+ * Land on the project selection screen with setup skipped. The app opens on
+ * the Home screen, so when the selection screen is not already mounted we take
+ * the "Open Project" shortcut from Home.
  */
 export const openProjectSelection = async (
   electronApp: ElectronApplication,
@@ -48,6 +69,19 @@ export const openProjectSelection = async (
   const appHelper = new AppHelper(electronApp, window);
   await appHelper.skipSetupIfPresent();
 
+  const selection = window.locator('[data-testid="project-selection"]');
+  const home = window.locator('[data-tour="tour-workspace-overview"]');
+
+  await Promise.race([
+    selection.waitFor({ state: 'visible', timeout: 10000 }),
+    home.waitFor({ state: 'visible', timeout: 10000 }),
+  ]);
+
+  if (await home.isVisible().catch(() => false)) {
+    await appHelper.dismissQuickStartTourIfPresent();
+    await window.locator('[data-tour="tour-open-project-btn"]').click();
+  }
+
   await window.waitForSelector('[data-testid="project-selection"]', {
     timeout: 10000,
   });
@@ -77,5 +111,9 @@ export const openProject = async (
   await expect(window.locator('[data-testid="sidebar"]')).toBeVisible({
     timeout: 30000,
   });
+
+  // The app opens on the Home screen, so enter the selected project's
+  // workspace to mount the project-scoped chrome (file tree, dbt actions).
+  await window.locator('[data-testid="nav-item-files"]').click();
   return window;
 };

e2e/page-objects/components/QuickStartTour.ts

@@ -1,9 +1,9 @@
 /**
  * Quick Start Tour Component
  *
- * Page object for the custom onboarding tour overlay shown on the project
- * selection screen for users with no projects. It has no testids, so it is
- * located through its visible text and the "Skip tour" icon title.
+ * Page object for the custom onboarding tour overlay shown on the Home screen
+ * (dashboard) for users with no projects. It has no testids, so it is located
+ * through its visible text and the "Skip tour" icon title.
  */
 
 import { Page, Locator, expect } from '@playwright/test';

e2e/tests/onboarding/quick-start-tour.spec.ts

@@ -1,14 +1,14 @@
 /**
  * Quick Start Tour Tests
  *
- * The tour auto-opens on the project selection screen when there are no
+ * The tour auto-opens on the Home screen (dashboard) when there are no
  * projects and it has not been seen before. Its overlay blocks the whole
  * page until it is skipped or completed. The fixture suppresses it by
  * default; these specs opt back in.
  */
 
 import { test, expect } from '../../fixtures/electron.fixture';
-import { openProjectSelection } from '../../helpers/window.helper';
+import { openHome } from '../../helpers/window.helper';
 import { QuickStartTourComponent } from '../../page-objects/components/QuickStartTour';
 import { ProjectSelectionPage } from '../../page-objects/screens/ProjectSelection';
 
@@ -18,7 +18,7 @@ test.describe('Quick Start Tour', () => {
   test('should open automatically for a new user with no projects', async ({
     electronApp,
   }) => {
-    const window = await openProjectSelection(electronApp);
+    const window = await openHome(electronApp);
     const tour = new QuickStartTourComponent(window);
 
     await tour.expectVisible();
@@ -32,52 +32,56 @@ test.describe('Quick Start Tour', () => {
   test('should block the page underneath until dismissed', async ({
     electronApp,
   }) => {
-    const window = await openProjectSelection(electronApp);
+    const window = await openHome(electronApp);
     const tour = new QuickStartTourComponent(window);
     const projectSelection = new ProjectSelectionPage(window);
 
     await tour.expectVisible();
 
     // The overlay intercepts pointer events, so a normal click never lands
+    const openProjectBtn = window.locator('[data-tour="tour-open-project-btn"]');
     await expect(
-      projectSelection.createProjectBtn.click({ timeout: 1500 }),
+      openProjectBtn.click({ timeout: 1500 }),
     ).rejects.toThrow();
 
     await tour.skip();
     await tour.expectHidden();
 
     // Now the page is interactive again
-    await projectSelection.clickCreateProject();
-    await expect(
-      window.locator('[data-testid="project-name-input"]'),
-    ).toBeVisible();
+    await openProjectBtn.click();
+    await expect(projectSelection.container).toBeVisible();
   });
 
   test('should step forward and back through the tour', async ({
     electronApp,
   }) => {
-    const window = await openProjectSelection(electronApp);
+    const window = await openHome(electronApp);
     const tour = new QuickStartTourComponent(window);
 
     await tour.expectStep(1);
     await tour.letsGo();
     await tour.expectStep(2);
     await expect(
-      window.getByRole('heading', { name: 'Your Projects' }),
+      window.getByRole('heading', { name: 'Workspace Overview' }),
     ).toBeVisible();
+    await expect(window.getByText('Your Home Screen')).toBeVisible();
 
     await tour.next();
     await tour.expectStep(3);
+    await expect(window.getByText('Studio Modules').first()).toBeVisible();
+
+    await tour.next();
+    await tour.expectStep(4);
     await expect(
-      window.getByRole('heading', { name: 'Create a New Project' }),
+      window.getByText('Recent Projects', { exact: true }),
     ).toBeVisible();
 
     await tour.back();
-    await tour.expectStep(2);
+    await tour.expectStep(3);
   });
 
   test('should mark the tour as seen when skipped', async ({ electronApp }) => {
-    const window = await openProjectSelection(electronApp);
+    const window = await openHome(electronApp);
     const tour = new QuickStartTourComponent(window);
 
     await tour.expectVisible();
@@ -90,7 +94,7 @@ test.describe('Quick Start Tour', () => {
   test('should close with the skip icon at any step', async ({
     electronApp,
   }) => {
-    const window = await openProjectSelection(electronApp);
+    const window = await openHome(electronApp);
     const tour = new QuickStartTourComponent(window);
 
     await tour.letsGo();
@@ -102,7 +106,7 @@ test.describe('Quick Start Tour', () => {
   });
 
   test('should finish with Done on the last step', async ({ electronApp }) => {
-    const window = await openProjectSelection(electronApp);
+    const window = await openHome(electronApp);
     const tour = new QuickStartTourComponent(window);
 
     await tour.letsGo();
@@ -128,7 +132,7 @@ test.describe('Quick Start Tour', () => {
     test('should not open when the user already has projects', async ({
       electronApp,
     }) => {
-      const window = await openProjectSelection(electronApp);
+      const window = await openHome(electronApp);
       const tour = new QuickStartTourComponent(window);
 
       // Give the 700ms auto-open timer a chance to fire
@@ -144,7 +148,7 @@ test.describe('Quick Start Tour - fixture default', () => {
   test('should be suppressed by the fixture for ordinary specs', async ({
     electronApp,
   }) => {
-    const window = await openProjectSelection(electronApp);
+    const window = await openHome(electronApp);
     const tour = new QuickStartTourComponent(window);
 
     await window.waitForTimeout(1500);

e2e/tests/projects/project-lifecycle.spec.ts

@@ -1,7 +1,7 @@
 import { Page, ElectronApplication } from '@playwright/test';
 import { test, expect } from '../../fixtures/electron.fixture';
 import { ProjectSelectionPage } from '../../page-objects/screens/ProjectSelection';
-import { AppHelper } from '../../helpers/app.helper';
+import { openProjectSelection } from '../../helpers/window.helper';
 
 // Helper to find a stable window (after splash screen closes)
 const findStableWindow = async (
@@ -31,17 +31,7 @@ const findStableWindow = async (
 
 test.describe('Project Lifecycle', () => {
   test.beforeEach(async ({ electronApp }) => {
-    // Wait for stable window (splash screen to close)
-    const stableWindow = await findStableWindow(electronApp);
-    await stableWindow.waitForLoadState('domcontentloaded');
-
-    const appHelper = new AppHelper(electronApp, stableWindow);
-    await appHelper.skipSetupIfPresent();
-
-    // Wait for project selection screen to be visible
-    await stableWindow.waitForSelector('[data-testid="project-selection"]', {
-      timeout: 10000,
-    });
+    await openProjectSelection(electronApp);
   });
 
   test('should create a new project', async ({ electronApp }) => {

e2e/tests/projects/project-selection.spec.ts

@@ -12,7 +12,7 @@ import * as path from 'path';
 import { Page, ElectronApplication } from '@playwright/test';
 import { test, expect } from '../../fixtures/electron.fixture';
 import { ProjectSelectionPage } from '../../page-objects/screens/ProjectSelection';
-import { AppHelper } from '../../helpers/app.helper';
+import { openProjectSelection } from '../../helpers/window.helper';
 
 // Helper to find a stable window (after splash screen closes)
 const findStableWindow = async (
@@ -45,15 +45,7 @@ const errorToast = (page: Page, text: string) =>
 
 test.describe('Project Selection', () => {
   test.beforeEach(async ({ electronApp }) => {
-    const stableWindow = await findStableWindow(electronApp);
-    await stableWindow.waitForLoadState('domcontentloaded');
-
-    const appHelper = new AppHelper(electronApp, stableWindow);
-    await appHelper.skipSetupIfPresent();
-
-    await stableWindow.waitForSelector('[data-testid="project-selection"]', {
-      timeout: 10000,
-    });
+    await openProjectSelection(electronApp);
   });
 
   test.describe('with no projects', () => {

e2e/tests/shell/app-shell.spec.ts

@@ -8,6 +8,7 @@
 
 import { test, expect } from '../../fixtures/electron-seeded.fixture';
 import { openProject } from '../../helpers/window.helper';
+import { NavigationSidebarComponent } from '../../page-objects/components/NavigationSidebar';
 
 const PROJECT = 'test_project';
 
@@ -63,7 +64,11 @@ test.describe('App Shell', () => {
   test('should open the AI assistant and point to provider settings', async ({
     electronApp,
   }) => {
+    // The assistant pane is mounted by the workspace screens (SQL/Notebooks/
+    // project details), so open it from the SQL editor.
     const window = await openProject(electronApp, PROJECT);
+    const nav = new NavigationSidebarComponent(window);
+    await nav.goToSqlEditor();
 
     await window.getByRole('button', { name: 'AI Assistant (beta)' }).click();
 

src/renderer/App.tsx

@@ -25,6 +25,7 @@ import {
   DuckLake as DataLake,
   Notebooks,
   Flows,
+  Dashboard,
 } from './screens';
 import { SelectProjectLayout, AppShell } from './layouts';
 import {
@@ -45,12 +46,14 @@ const App: React.FC = () => {
       <ScrollbarStyles />
       <Routes>
         <Route path="/" element={<SelectProjectLayout />}>
-          <Route path="/select-project" element={<SelectProject />} />
-          <Route path="/setup" element={<Setup />} />
-          <Route path="*" element={<Navigate to="/" />} />
+          <Route index element={<Navigate to="/app" replace />} />
+          <Route path="select-project" element={<SelectProject />} />
+          <Route path="setup" element={<Setup />} />
+          <Route path="*" element={<Navigate to="/app" />} />
         </Route>
         <Route path="/app" element={<AppShell />}>
-          <Route path="" element={<ProjectDetails />} />
+          <Route path="" element={<Dashboard />} />
+          <Route path="dbt-project" element={<ProjectDetails />} />
           <Route path="connections" element={<Connections />} />
           <Route path="select-project" element={<SelectProject />} />
           <Route path="edit-connection/:id" element={<EditConnection />} />