From fe191752da53ea6b676976469e0763524c87996b Mon Sep 17 00:00:00 2001
From: gbanyan <gbanyan.huang@gmail.com>
Date: Wed, 19 Nov 2025 00:54:58 +0800
Subject: [PATCH] Add aesthetic timeline to post lists

---
 app/blog/page.tsx                      |  1 +
 app/page.tsx                           |  5 +++--
 components/post-list-item.tsx          |  3 ++-
 components/post-list-with-controls.tsx |  4 ++--
 components/timeline-wrapper.tsx        | 18 ++++++++++++++++++
 5 files changed, 26 insertions(+), 5 deletions(-)
 create mode 100644 components/timeline-wrapper.tsx

diff --git a/app/blog/page.tsx b/app/blog/page.tsx
index 3cd083d..2eca05e 100644
--- a/app/blog/page.tsx
+++ b/app/blog/page.tsx
@@ -1,5 +1,6 @@
 import { getAllPostsSorted } from '@/lib/posts';
 import { PostListWithControls } from '@/components/post-list-with-controls';
+import { TimelineWrapper } from '@/components/timeline-wrapper';
 
 export const metadata = {
   title: '所有文章'
diff --git a/app/page.tsx b/app/page.tsx
index 9e177f8..d7193db 100644
--- a/app/page.tsx
+++ b/app/page.tsx
@@ -2,6 +2,7 @@ import Link from 'next/link';
 import { getAllPostsSorted } from '@/lib/posts';
 import { siteConfig } from '@/lib/config';
 import { PostListItem } from '@/components/post-list-item';
+import { TimelineWrapper } from '@/components/timeline-wrapper';
 
 export default function HomePage() {
   const posts = getAllPostsSorted().slice(0, siteConfig.postsPerPage);
@@ -29,11 +30,11 @@ export default function HomePage() {
             所有文章 →
           </Link>
         </div>
-        <ul className="space-y-3">
+        <TimelineWrapper>
           {posts.map((post) => (
             <PostListItem key={post._id} post={post} />
           ))}
-        </ul>
+        </TimelineWrapper>
       </div>
     </section>
   );
diff --git a/components/post-list-item.tsx b/components/post-list-item.tsx
index 922fe55..61675b7 100644
--- a/components/post-list-item.tsx
+++ b/components/post-list-item.tsx
@@ -18,7 +18,8 @@ export function PostListItem({ post }: Props) {
     post.description || post.custom_excerpt || post.body?.raw?.slice(0, 120);
 
   return (
-    <li>
+    <li className="relative pl-6">
+      <span className="pointer-events-none absolute left-0 top-6 z-10 h-3 w-3 rounded-full border-2 border-white bg-gradient-to-br from-blue-500 via-sky-400 to-indigo-400 shadow-md dark:border-slate-900" aria-hidden="true" />
       <article className="motion-card group relative flex gap-4 rounded-lg border border-slate-200/70 bg-white/90 p-4 shadow-sm dark:border-slate-800 dark:bg-slate-900/80">
         <div className="pointer-events-none absolute inset-x-0 top-0 h-0.5 origin-left scale-x-0 bg-gradient-to-r from-blue-500 via-sky-400 to-indigo-500 opacity-80 transition-transform duration-300 ease-out group-hover:scale-x-100 dark:from-blue-400 dark:via-sky-300 dark:to-indigo-400" />
         {cover && (
diff --git a/components/post-list-with-controls.tsx b/components/post-list-with-controls.tsx
index 4812f38..c154a70 100644
--- a/components/post-list-with-controls.tsx
+++ b/components/post-list-with-controls.tsx
@@ -151,11 +151,11 @@ export function PostListWithControls({ posts, pageSize }: Props) {
           找不到符合關鍵字的文章，換個詞再試試？
         </div>
       ) : (
-        <ul className="space-y-3">
+        <div className="space-y-3">
           {currentPosts.map((post) => (
             <PostListItem key={post._id} post={post} />
           ))}
-        </ul>
+        </div>
       )}
 
       {totalPages > 1 && currentPosts.length > 0 && (
diff --git a/components/timeline-wrapper.tsx b/components/timeline-wrapper.tsx
new file mode 100644
index 0000000..8dbedd8
--- /dev/null
+++ b/components/timeline-wrapper.tsx
@@ -0,0 +1,18 @@
+import { ReactNode } from 'react';
+import clsx from 'clsx';
+
+interface TimelineWrapperProps {
+  children: ReactNode;
+  className?: string;
+}
+
+export function TimelineWrapper({ children, className }: TimelineWrapperProps) {
+  return (
+    <div className={clsx('relative pl-8', className)}>
+      <div className="pointer-events-none absolute left-3 top-0 h-full w-px bg-gradient-to-b from-transparent via-slate-200 to-transparent dark:via-slate-700" aria-hidden="true" />
+      <div className="space-y-4">
+        {children}
+      </div>
+    </div>
+  );
+}