From eca9af48507756c839e744c362b9555a964955f2 Mon Sep 17 00:00:00 2001
From: Pratyush Sharma <56130065+pratyush618@users.noreply.github.com>
Date: Sun, 3 May 2026 10:19:14 +0530
Subject: [PATCH 1/2] docs: redesign landing comparison as side-by-side + table

---
 docs/src/app/(home)/comparison.tsx | 201 +++++++++++++++++------------
 docs/src/app/(home)/page.tsx       |   2 +-
 2 files changed, 122 insertions(+), 81 deletions(-)

diff --git a/docs/src/app/(home)/comparison.tsx b/docs/src/app/(home)/comparison.tsx
index d7f0ea6..e209537 100644
--- a/docs/src/app/(home)/comparison.tsx
+++ b/docs/src/app/(home)/comparison.tsx
@@ -1,23 +1,4 @@
-"use client";
-
-import { useState } from "react";
-
-type Stack = "taskito" | "celery";
-
-const STACKS: Record<
-  Stack,
-  {
-    label: string;
-    services: string;
-    install: string;
-    code: string;
-  }
-> = {
-  taskito: {
-    label: "taskito",
-    services: "1 process",
-    install: "pip install taskito",
-    code: `from taskito import Queue
+const TASKITO_CODE = `from taskito import Queue
 
 queue = Queue(db_path="tasks.db")
 
@@ -29,13 +10,9 @@ def send_email(to, subject, body):
 send_email.delay("alice@example.com", "Hi", "Body")
 
 # Run the worker
-# $ taskito worker --app tasks:queue`,
-  },
-  celery: {
-    label: "Celery + Redis",
-    services: "3 processes (Redis + worker + beat)",
-    install: "pip install celery[redis]\n# also: install + run Redis server",
-    code: `from celery import Celery
+# $ taskito worker --app tasks:queue`;
+
+const CELERY_CODE = `from celery import Celery
 
 app = Celery(
     "myapp",
@@ -55,75 +32,139 @@ def send_email(self, to, subject, body):
 send_email.delay("alice@example.com", "Hi", "Body")
 
 # Run the worker (in a separate terminal, plus Redis)
-# $ celery -A myapp worker --loglevel=info`,
+# $ celery -A myapp worker --loglevel=info`;
+
+type Tone = "primary" | "muted";
+
+const ROWS: { label: string; taskito: string; celery: string }[] = [
+  {
+    label: "Install",
+    taskito: "pip install taskito",
+    celery: "pip install celery[redis] + run Redis daemon",
   },
-};
+  {
+    label: "Background services",
+    taskito: "1 (worker)",
+    celery: "3 (worker, beat, Redis)",
+  },
+  {
+    label: "Default storage",
+    taskito: "SQLite file (built-in)",
+    celery: "Redis (separate daemon)",
+  },
+  {
+    label: "Retry config in the example above",
+    taskito: "max_retries=3 decorator arg",
+    celery: "try/except + self.retry(exc=…)",
+  },
+];
 
 export function Comparison() {
-  const [stack, setStack] = useState<Stack>("taskito");
-  const data = STACKS[stack];
-
   return (
-    <div className="rounded-lg border border-fd-border bg-fd-card overflow-hidden">
-      <div className="flex border-b border-fd-border" role="tablist">
-        {(Object.keys(STACKS) as Stack[]).map((key) => {
-          const active = stack === key;
-          return (
-            <button
-              key={key}
-              type="button"
-              role="tab"
-              aria-selected={active}
-              onClick={() => setStack(key)}
-              className={`flex-1 px-4 py-3 text-sm font-medium transition-colors ${
-                active
-                  ? "bg-fd-primary/10 text-fd-foreground border-b-2 border-fd-primary -mb-px"
-                  : "text-fd-muted-foreground hover:text-fd-foreground hover:bg-fd-accent/50"
-              }`}
-            >
-              {STACKS[key].label}
-            </button>
-          );
-        })}
-      </div>
-      <div className="grid sm:grid-cols-3 gap-px bg-fd-border">
-        <Stat label="Install" value={data.install} mono />
-        <Stat label="Services to run" value={data.services} />
-        <Stat
-          label="Background"
-          value={
-            stack === "taskito"
-              ? "Single Python process"
-              : "Worker process + Redis daemon"
-          }
+    <div className="space-y-6">
+      <div className="grid md:grid-cols-2 gap-4">
+        <CodePanel
+          label="taskito"
+          caption="Brokerless · single process"
+          tone="primary"
+          code={TASKITO_CODE}
+        />
+        <CodePanel
+          label="Celery + Redis"
+          caption="Requires Redis · 3 processes"
+          tone="muted"
+          code={CELERY_CODE}
         />
       </div>
-      <pre className="p-5 text-sm font-mono leading-relaxed overflow-x-auto bg-fd-card">
-        <code>{data.code}</code>
-      </pre>
+      <DifferentiatorTable />
     </div>
   );
 }
 
-function Stat({
+function CodePanel({
   label,
-  value,
-  mono,
+  caption,
+  tone,
+  code,
 }: {
   label: string;
-  value: string;
-  mono?: boolean;
+  caption: string;
+  tone: Tone;
+  code: string;
 }) {
+  const accent =
+    tone === "primary" ? "border-t-fd-primary" : "border-t-fd-border";
   return (
-    <div className="bg-fd-card px-4 py-3">
-      <div className="text-xs uppercase tracking-wider text-fd-muted-foreground mb-1">
-        {label}
-      </div>
-      <div
-        className={`text-sm whitespace-pre-line ${mono ? "font-mono" : "font-medium"}`}
-      >
-        {value}
+    <div
+      className={`rounded-lg border border-fd-border border-t-2 bg-fd-card overflow-hidden ${accent}`}
+    >
+      <div className="flex items-baseline justify-between px-4 py-3 border-b border-fd-border bg-fd-muted">
+        <span
+          className={`text-sm font-semibold ${
+            tone === "primary" ? "text-fd-primary" : "text-fd-foreground"
+          }`}
+        >
+          {label}
+        </span>
+        <span className="text-xs text-fd-muted-foreground">{caption}</span>
       </div>
+      <pre className="p-5 text-sm font-mono leading-relaxed overflow-x-auto bg-fd-card">
+        <code>{code}</code>
+      </pre>
+    </div>
+  );
+}
+
+function DifferentiatorTable() {
+  return (
+    <div className="rounded-lg border border-fd-border bg-fd-card overflow-hidden">
+      <table className="w-full border-collapse text-xs sm:text-sm">
+        <thead>
+          <tr className="border-b border-fd-border bg-fd-muted">
+            <th
+              scope="col"
+              className="text-left px-4 py-3 font-medium text-fd-muted-foreground"
+            >
+              <span className="sr-only">Property</span>
+            </th>
+            <th
+              scope="col"
+              className="text-left px-4 py-3 font-semibold text-fd-primary"
+            >
+              taskito
+            </th>
+            <th
+              scope="col"
+              className="text-left px-4 py-3 font-semibold text-fd-foreground"
+            >
+              Celery + Redis
+            </th>
+          </tr>
+        </thead>
+        <tbody>
+          {ROWS.map((row, i) => (
+            <tr
+              key={row.label}
+              className={
+                i < ROWS.length - 1 ? "border-b border-fd-border" : undefined
+              }
+            >
+              <th
+                scope="row"
+                className="text-left px-4 py-3 font-medium text-fd-muted-foreground align-top"
+              >
+                {row.label}
+              </th>
+              <td className="px-4 py-3 align-top text-fd-foreground">
+                {row.taskito}
+              </td>
+              <td className="px-4 py-3 align-top text-fd-muted-foreground">
+                {row.celery}
+              </td>
+            </tr>
+          ))}
+        </tbody>
+      </table>
     </div>
   );
 }
diff --git a/docs/src/app/(home)/page.tsx b/docs/src/app/(home)/page.tsx
index b1869ae..0246559 100644
--- a/docs/src/app/(home)/page.tsx
+++ b/docs/src/app/(home)/page.tsx
@@ -196,7 +196,7 @@ function ComparisonSection() {
           Less to operate
         </h2>
         <p className="text-fd-muted-foreground text-lg">
-          The same task, two stacks. Pick the one with fewer moving parts.
+          The same task, two stacks. Side by side, with the operational delta.
         </p>
       </div>
       <Comparison />

From 4f9b2bdfb72a462af1a0b6ab5c5be707aa55914f Mon Sep 17 00:00:00 2001
From: Pratyush Sharma <56130065+pratyush618@users.noreply.github.com>
Date: Sun, 3 May 2026 10:25:27 +0530
Subject: [PATCH 2/2] docs: syntax-highlight comparison panels via fumadocs
 highlight

---
 docs/src/app/(home)/comparison.tsx | 47 +++++++++++++++++++++++-------
 1 file changed, 37 insertions(+), 10 deletions(-)

diff --git a/docs/src/app/(home)/comparison.tsx b/docs/src/app/(home)/comparison.tsx
index e209537..37a82c2 100644
--- a/docs/src/app/(home)/comparison.tsx
+++ b/docs/src/app/(home)/comparison.tsx
@@ -1,3 +1,5 @@
+import { highlight } from "fumadocs-core/highlight";
+
 const TASKITO_CODE = `from taskito import Queue
 
 queue = Queue(db_path="tasks.db")
@@ -59,7 +61,12 @@ const ROWS: { label: string; taskito: string; celery: string }[] = [
   },
 ];
 
-export function Comparison() {
+export async function Comparison() {
+  const [taskitoHighlighted, celeryHighlighted] = await Promise.all([
+    renderHighlighted(TASKITO_CODE),
+    renderHighlighted(CELERY_CODE),
+  ]);
+
   return (
     <div className="space-y-6">
       <div className="grid md:grid-cols-2 gap-4">
@@ -67,30 +74,52 @@ export function Comparison() {
           label="taskito"
           caption="Brokerless · single process"
           tone="primary"
-          code={TASKITO_CODE}
-        />
+        >
+          {taskitoHighlighted}
+        </CodePanel>
         <CodePanel
           label="Celery + Redis"
           caption="Requires Redis · 3 processes"
           tone="muted"
-          code={CELERY_CODE}
-        />
+        >
+          {celeryHighlighted}
+        </CodePanel>
       </div>
       <DifferentiatorTable />
     </div>
   );
 }
 
+async function renderHighlighted(code: string) {
+  return highlight(code, {
+    lang: "python",
+    themes: {
+      light: "github-light",
+      dark: "github-dark",
+    },
+    components: {
+      pre: ({ children, ...props }) => (
+        <pre
+          {...props}
+          className="p-5 text-sm leading-relaxed overflow-x-auto bg-fd-card"
+        >
+          {children}
+        </pre>
+      ),
+    },
+  });
+}
+
 function CodePanel({
   label,
   caption,
   tone,
-  code,
+  children,
 }: {
   label: string;
   caption: string;
   tone: Tone;
-  code: string;
+  children: React.ReactNode;
 }) {
   const accent =
     tone === "primary" ? "border-t-fd-primary" : "border-t-fd-border";
@@ -108,9 +137,7 @@ function CodePanel({
         </span>
         <span className="text-xs text-fd-muted-foreground">{caption}</span>
       </div>
-      <pre className="p-5 text-sm font-mono leading-relaxed overflow-x-auto bg-fd-card">
-        <code>{code}</code>
-      </pre>
+      {children}
     </div>
   );
 }