- Add an Analytics entry to the project sidebar and a dedicated /projects/[projectId]/analytics page for CRUD operations on project's analytics config only.

- No Analytics Configuration card when none exist, matching the style of the file and email config pages.
- getAnalyticsConfig returns null only on 404; throws 401 for auth failures and shows an error alert instead of looking like an empty state
- Delete the config by the current projectId, not the table row id; only one config could be made which would always be row id = 0, passing 0 as the parameter in function that deletes configs by projectId (always deleted project 0 config id)
- Move the analytics table out of Settings; point the project dashboard card at the new page; add the "Analytics" top bar title

Author: aishanibal

src/app/(dashboard)/projects/[projectId]/analytics/page.tsx

@@ -0,0 +1,66 @@
+"use client";
+
+import { AnalyticsConfigTable } from "@/components/analyticsConfigTable/analyticsConfig-table";
+import {
+  Breadcrumb,
+  BreadcrumbItem,
+  BreadcrumbLink,
+  BreadcrumbList,
+  BreadcrumbPage,
+  BreadcrumbSeparator,
+} from "@/components/ui/breadcrumb";
+import { Separator } from "@/components/ui/separator";
+import { getProjectById } from "@/lib/project";
+import { useQuery } from "@tanstack/react-query";
+import { ProjectResponse } from "juno-sdk/build/main/internal/index";
+import { useParams } from "next/navigation";
+import { toast } from "sonner";
+
+const ProjectAnalyticsPage = () => {
+  const { projectId } = useParams<{ projectId: string }>();
+
+  const { isLoading, isError, data, error } = useQuery<ProjectResponse>({
+    queryKey: ["project", projectId],
+    queryFn: async () => {
+      const result = await getProjectById(Number(projectId));
+      if (!result.success) {
+        throw new Error(result.error);
+      }
+      return result.project;
+    },
+  });
+
+  if (isError) {
+    toast.error("Error", {
+      description: `Failed to fetch project: ${JSON.stringify(error)}`,
+    });
+  }
+
+  return (
+    <div className="flex flex-col">
+      <Breadcrumb className="mb-4">
+        <BreadcrumbList>
+          <BreadcrumbItem>
+            <BreadcrumbLink href="/projects">Projects</BreadcrumbLink>
+          </BreadcrumbItem>
+          <BreadcrumbSeparator />
+          <BreadcrumbItem>
+            <BreadcrumbLink href={`/projects/${projectId}`}>
+              {isLoading ? "****" : (data?.name ?? "Unknown")}
+            </BreadcrumbLink>
+          </BreadcrumbItem>
+          <BreadcrumbSeparator />
+          <BreadcrumbItem>
+            <BreadcrumbPage>Analytics</BreadcrumbPage>
+          </BreadcrumbItem>
+        </BreadcrumbList>
+      </Breadcrumb>
+      <Separator className="mb-8" />
+      <div className="flex flex-col gap-8">
+        <AnalyticsConfigTable projectId={projectId} />
+      </div>
+    </div>
+  );
+};
+
+export default ProjectAnalyticsPage;

src/app/(dashboard)/projects/[projectId]/page.tsx

@@ -31,7 +31,7 @@ import {
 } from "@/lib/settings";
 import { useQuery } from "@tanstack/react-query";
 import type { ProjectResponse } from "juno-sdk/build/main/internal/index";
-import { BarChart3, Settings } from "lucide-react";
+import { BarChart3 } from "lucide-react";
 import Link from "next/link";
 import { useParams } from "next/navigation";
 import { useEffect, useMemo, useState } from "react";
@@ -575,9 +575,9 @@ const DashboardPage = () => {
               clicks, and custom events using Juno.
             </p>
             <Button asChild>
-              <Link href={`/projects/${projectId}/settings`}>
-                <Settings className="mr-2 h-4 w-4" />
-                Go to Settings
+              <Link href={`/projects/${projectId}/analytics`}>
+                <BarChart3 className="mr-2 h-4 w-4" />
+                Set up analytics
               </Link>
             </Button>
           </CardContent>

src/app/(dashboard)/projects/[projectId]/settings/page.tsx

@@ -1,6 +1,5 @@
 "use client";
 
-import { AnalyticsConfigTable } from "@/components/analyticsConfigTable/analyticsConfig-table";
 import { EmailConfigTable } from "@/components/emailConfigTable/emailConfig-table";
 import { FileConfigTable } from "@/components/fileConfigTable/fileConfig-table";
 import {
@@ -61,7 +60,6 @@ const ProjectSettingsPage = () => {
       <div className="flex flex-col gap-8">
         <FileConfigTable projectId={projectId} />
         <EmailConfigTable projectId={projectId} />
-        <AnalyticsConfigTable projectId={projectId} />
       </div>
     </div>
   );

src/components/analyticsConfigTable/analyticsConfig-table.tsx

@@ -12,12 +12,15 @@ import {
   getAnalyticsConfig,
   updateAnalyticsConfig,
 } from "@/lib/settings";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { ChartColumn, CircleX } from "lucide-react";
 import { useState } from "react";
 import { toast } from "sonner";
 import { useReadOnlyMode } from "../providers/SessionProvider";
 import { BaseTable } from "../baseTable";
 import AddAnalyticsConfigForm from "../forms/AddAnalyticsConfigForm";
+import { Alert } from "../ui/alert";
 import { Button } from "../ui/button";
 import { DialogFooter, DialogHeader } from "../ui/dialog";
 import { analyticsConfigColumns } from "./columns";
@@ -48,14 +51,7 @@ export function AnalyticsConfigTable({ projectId }: AnalyticsConfigTableProps) {
   }
 
   const deleteAnalyticsConfigHandler = useMutation({
-    mutationFn: () => {
-      const deletePromises = selectedRows.map(async (row) => {
-        const projectId = row.id;
-        return deleteAnalyticsConfig(projectId);
-      });
-
-      return Promise.all(deletePromises);
-    },
+    mutationFn: async () => deleteAnalyticsConfig(projectId),
     onSuccess: () => {
       toast.success("Success", {
         description: `Successfully deleted analytics configs.`,
@@ -163,48 +159,82 @@ export function AnalyticsConfigTable({ projectId }: AnalyticsConfigTableProps) {
         </DialogContent>
       </Dialog>
       <h1 className="text-lg font-bold">Analytics Configurations</h1>
-      <BaseTable
-        data={analyticsConfigRowData}
-        columns={analyticsConfigColumns(
-          Number(projectId),
-          addAnalyticsConfigHandler.isPending,
-          (
-            projectId: number,
-            keys: {
-              serverAnalyticsKey: string;
-              clientAnalyticsKey: string;
+      {isError && (
+        <Alert className="border-red-500/20 bg-red-500/10">
+          <div className="flex items-center gap-2 text-red-400">
+            <CircleX className="h-4 w-4" />
+            <span className="text-sm">
+              Couldn&apos;t load analytics config: {error.message}
+            </span>
+          </div>
+        </Alert>
+      )}
+      {isError ? null : !isLoading && analyticsConfigRowData.length === 0 ? (
+        <Card className="max-w-[35%]">
+          <CardHeader>
+            <div className="flex items-center gap-3">
+              <ChartColumn className="h-5 w-5 text-muted-foreground" />
+              <CardTitle>No Analytics Configuration</CardTitle>
+            </div>
+          </CardHeader>
+          <CardContent>
+            <p className="text-sm text-muted-foreground mb-4">
+              Project {projectId} has no analytics configuration yet. Add a
+              server key and a client key to start tracking user interactions,
+              visits, clicks, and custom events using Juno.
+            </p>
+            <Button
+              onClick={() => setIsAddConfigDialogOpen(true)}
+              disabled={isReadOnly || addAnalyticsConfigHandler.isPending}
+            >
+              Set up analytics
+            </Button>
+          </CardContent>
+        </Card>
+      ) : (
+        <BaseTable
+          data={analyticsConfigRowData}
+          columns={analyticsConfigColumns(
+            Number(projectId),
+            addAnalyticsConfigHandler.isPending,
+            (
+              projectId: number,
+              keys: {
+                serverAnalyticsKey: string;
+                clientAnalyticsKey: string;
+              },
+            ) => {
+              const { serverAnalyticsKey, clientAnalyticsKey } = keys;
+              updateAnalyticsConfigHandler.mutate({
+                projectId,
+                serverAnalyticsKey,
+                clientAnalyticsKey,
+              });
+              setIsAddConfigDialogOpen(false);
             },
-          ) => {
-            const { serverAnalyticsKey, clientAnalyticsKey } = keys;
-            updateAnalyticsConfigHandler.mutate({
-              projectId,
-              serverAnalyticsKey,
-              clientAnalyticsKey,
-            });
-            setIsAddConfigDialogOpen(false);
-          },
-          isReadOnly,
-        )}
-        isLoading={isLoading}
-        filterParams={{
-          placeholder: "Filter by environment...",
-          filterColumn: "environment",
-        }}
-        onAddNewRow={() => {
-          if (analyticsConfigRowData.length === 0) {
-            setIsAddConfigDialogOpen(true);
-          } else {
-            toast.error("Error", {
-              description:
-                "Project can have at most 1 analytics configuration per environment",
-            });
-          }
-        }}
-        onDeleteRow={(rows) => {
-          setSelectedRows(rows);
-          setIsDeleteDialogOpen(true);
-        }}
-      />
+            isReadOnly,
+          )}
+          isLoading={isLoading}
+          filterParams={{
+            placeholder: "Filter by environment...",
+            filterColumn: "environment",
+          }}
+          onAddNewRow={() => {
+            if (analyticsConfigRowData.length === 0) {
+              setIsAddConfigDialogOpen(true);
+            } else {
+              toast.error("Error", {
+                description:
+                  "Project can have at most 1 analytics configuration per environment",
+              });
+            }
+          }}
+          onDeleteRow={(rows) => {
+            setSelectedRows(rows);
+            setIsDeleteDialogOpen(true);
+          }}
+        />
+      )}
     </div>
   );
 }

src/components/sidebar/project-sidebar.tsx

@@ -9,6 +9,7 @@ import {
   Settings,
   Shield,
   User,
+  ChartColumn,
 } from "lucide-react";
 
 import {
@@ -125,6 +126,11 @@ export function ProjectSidebar({
       url: `/projects/${projectId}/settings`,
       icon: Settings,
     },
+    {
+      title: "Analytics",
+      url: `/projects/${projectId}/analytics`,
+      icon: ChartColumn,
+    },
   ];
 
   return (

src/components/top-bar.tsx

@@ -22,6 +22,7 @@ function getPageTitle(pathname: string): string {
     if (sub === "/services/email") return "Email";
     if (sub === "/services/files") return "Files";
     if (sub === "/settings") return "Settings";
+    if (sub === "/analytics") return "Analytics";
   }
 
   return "Dashboard";

src/lib/settings.ts

@@ -126,7 +126,7 @@ export async function getEmailConfig(
 
 export async function getAnalyticsConfig(
   projectId: string,
-): Promise<AnalyticsConfigResponse> {
+): Promise<AnalyticsConfigResponse | null> {
   const session = await getSession();
   if (!session) {
     throw new Error("Unauthorized");
@@ -147,9 +147,14 @@ export async function getAnalyticsConfig(
     );
     return JSON.parse(JSON.stringify(analyticsConfig));
   } catch (e) {
-    if (e.response?.status === 404 || e.response?.status === 401) {
+    if (e.response?.status === 404) {
       return null;
     }
+    if (e.response?.status === 401) {
+      throw new Error(
+        `Unauthorized: Juno rejected the request for project ${projectId}. The API key may be missing, invalid, or not permitted for this project.`,
+      );
+    }
     throw e;
   }
 }