From 301fb3f8f846f16602ef487fb1b1cc6b6e228541 Mon Sep 17 00:00:00 2001
From: Che <30403707+Che-Zhu@users.noreply.github.com>
Date: Sun, 14 Dec 2025 17:20:42 +0800
Subject: [PATCH 1/2] feat(project-list): add skeleton loading state

- Add ProjectCardSkeleton component for better loading experience
- Replace spinner with skeleton in ProjectListContent
- Prevent layout shift during data fetching
---
 .../projectList/ProjectCardSkeleton.tsx       | 36 +++++++++++++++++++
 .../projectList/ProjectListContent.tsx        | 11 +++---
 2 files changed, 42 insertions(+), 5 deletions(-)
 create mode 100644 components/features/projectList/ProjectCardSkeleton.tsx

diff --git a/components/features/projectList/ProjectCardSkeleton.tsx b/components/features/projectList/ProjectCardSkeleton.tsx
new file mode 100644
index 0000000..928c054
--- /dev/null
+++ b/components/features/projectList/ProjectCardSkeleton.tsx
@@ -0,0 +1,36 @@
+import { Card, CardFooter, CardHeader } from '@/components/ui/card';
+import { Skeleton } from '@/components/ui/skeleton';
+
+export default function ProjectCardSkeleton() {
+  return (
+    <Card className="h-full border border-border rounded-md p-5 flex flex-col gap-4">
+      <CardHeader className="px-0 pt-0 pb-2">
+        <div className="flex justify-between items-start">
+          <div className="flex flex-col gap-1 w-full">
+            <Skeleton className="h-6 w-3/4" />
+          </div>
+          <Skeleton className="h-8 w-8 rounded-md" />
+        </div>
+        
+        <div className="mt-2 space-y-2">
+          <Skeleton className="h-4 w-full" />
+          <Skeleton className="h-4 w-2/3" />
+        </div>
+      </CardHeader>
+
+      <div className="border-t border-border" />
+
+      <CardFooter className="flex items-center justify-between px-0">
+        <div className="flex items-center gap-x-2">
+          <Skeleton className="h-2 w-2 rounded-full" />
+          <Skeleton className="h-3 w-16" />
+        </div>
+
+        <div className="flex items-center gap-2">
+          <Skeleton className="h-3 w-3 rounded-full" />
+          <Skeleton className="h-3 w-12" />
+        </div>
+      </CardFooter>
+    </Card>
+  );
+}
diff --git a/components/features/projectList/ProjectListContent.tsx b/components/features/projectList/ProjectListContent.tsx
index d983e66..8cbb158 100644
--- a/components/features/projectList/ProjectListContent.tsx
+++ b/components/features/projectList/ProjectListContent.tsx
@@ -3,7 +3,7 @@
 
 import EmptyProjectCard from '@/components/features/projectList/EmptyProjectCard';
 import ProjectCard from '@/components/features/projectList/ProjectCard';
-import { Spinner } from '@/components/ui/spinner';
+import ProjectCardSkeleton from '@/components/features/projectList/ProjectCardSkeleton';
 import { useProjects } from '@/hooks/use-projects';
 
 export default function ProjectListContent() {
@@ -13,10 +13,11 @@ export default function ProjectListContent() {
 
   if (isLoading) {
     return (
-      <div className="min-h-screen flex items-center justify-center">
-        <div className="flex items-center gap-3">
-          <Spinner className="h-5 w-5 text-primary" />
-          <span className="text-sm text-muted-foreground">Loading projects...</span>
+      <div className="mt-6">
+        <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
+          {Array.from({ length: 3 }).map((_, i) => (
+            <ProjectCardSkeleton key={i} />
+          ))}
         </div>
       </div>
     );

From 01d14fa1f852002e1d81593dc4354974b5e97298 Mon Sep 17 00:00:00 2001
From: Che <30403707+Che-Zhu@users.noreply.github.com>
Date: Sun, 14 Dec 2025 17:46:55 +0800
Subject: [PATCH 2/2] feat(project-details): add loading.tsx for better route
 transition

- Add loading skeleton for project layout
- Improve perceived performance on route change
---
 app/projects/[id]/loading.tsx | 48 +++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 app/projects/[id]/loading.tsx

diff --git a/app/projects/[id]/loading.tsx b/app/projects/[id]/loading.tsx
new file mode 100644
index 0000000..8a8b769
--- /dev/null
+++ b/app/projects/[id]/loading.tsx
@@ -0,0 +1,48 @@
+import { Skeleton } from '@/components/ui/skeleton';
+
+export default function Loading() {
+  return (
+    <div className="h-screen flex flex-col text-foreground overflow-hidden">
+      <div className="flex-1 flex overflow-hidden">
+        {/* Primary Sidebar Skeleton */}
+        <div className="w-[50px] border-r border-border bg-card flex flex-col items-center py-4 gap-4">
+          <Skeleton className="h-8 w-8 rounded-md" />
+          <Skeleton className="h-8 w-8 rounded-md" />
+          <Skeleton className="h-8 w-8 rounded-md" />
+        </div>
+
+        {/* Project Sidebar Skeleton */}
+        <div className="w-60 border-r border-border bg-card/50 flex flex-col">
+          <div className="h-12 border-b border-border flex items-center px-4">
+            <Skeleton className="h-4 w-32" />
+          </div>
+          <div className="p-4 space-y-4">
+            <Skeleton className="h-8 w-full" />
+            <Skeleton className="h-8 w-full" />
+            <Skeleton className="h-8 w-full" />
+          </div>
+        </div>
+
+        {/* Main Content Area Skeleton */}
+        <div className="flex-1 flex flex-col min-w-0 relative overflow-hidden bg-background">
+          <div className="h-14 border-b border-border flex items-center px-6">
+            <Skeleton className="h-5 w-48" />
+          </div>
+          <div className="p-6">
+            <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
+              <Skeleton className="h-40 w-full rounded-xl" />
+              <Skeleton className="h-40 w-full rounded-xl" />
+              <Skeleton className="h-40 w-full rounded-xl" />
+            </div>
+          </div>
+        </div>
+      </div>
+      
+      {/* Status Bar Skeleton */}
+      <div className="h-6 border-t border-border bg-card flex items-center px-2 gap-4">
+        <Skeleton className="h-3 w-24" />
+        <Skeleton className="h-3 w-32" />
+      </div>
+    </div>
+  );
+}