From 328aaa75baf0b18fa7dc720ab01f09c91b98ebfa Mon Sep 17 00:00:00 2001
From: armorbreak001 <contact@agentvote.cc>
Date: Tue, 14 Apr 2026 19:21:02 +0800
Subject: [PATCH] feat(frontend): add Guild Settings Layout scaffold with
 sidebar navigation

Fixes #275

- Create SettingsLayout with persistent left sidebar
- Navigation links: General, Members, Treasury, Integrations
- Active link highlighting via pathname matching
- Mobile responsive: collapses to hamburger menu at md breakpoint
- Central <main> content area for settings pages
- Demo page with mock form showing General settings
---
 .../components/guild/SettingsLayout.demo.tsx  |  73 ++++++++++
 .../src/components/guild/SettingsLayout.tsx   | 137 ++++++++++++++++++
 frontend/src/components/guild/index.ts        |   5 +-
 3 files changed, 214 insertions(+), 1 deletion(-)
 create mode 100644 frontend/src/components/guild/SettingsLayout.demo.tsx
 create mode 100644 frontend/src/components/guild/SettingsLayout.tsx

diff --git a/frontend/src/components/guild/SettingsLayout.demo.tsx b/frontend/src/components/guild/SettingsLayout.demo.tsx
new file mode 100644
index 0000000..8217832
--- /dev/null
+++ b/frontend/src/components/guild/SettingsLayout.demo.tsx
@@ -0,0 +1,73 @@
+'use client';
+
+import React from 'react';
+import { SettingsLayout } from './SettingsLayout';
+
+/**
+ * Demo page showcasing the Guild Settings Layout.
+ * Uses dummy router hooks (no actual routing required).
+ */
+export default function SettingsLayoutDemo(): JSX.Element {
+  return (
+    <SettingsLayout guildName="Stellar Builders Guild">
+      <div className="space-y-6">
+        {/* Page header */}
+        <div>
+          <h1 className="text-2xl font-bold text-gray-900 dark:text-white">
+            General Settings
+          </h1>
+          <p className="text-sm text-gray-500 dark:text-gray-400 mt-1">
+            Manage your guild&apos;s basic information and configuration.
+          </p>
+        </div>
+
+        {/* Mock form */}
+        <div className="max-w-2xl space-y-5">
+          <div className="bg-white rounded-xl border border-gray-200 p-6 dark:bg-gray-900 dark:border-gray-800">
+            <h2 className="text-lg font-semibold text-gray-900 dark:text-white mb-4">
+              Guild Profile
+            </h2>
+
+            <div className="space-y-4">
+              <div>
+                <label
+                  htmlFor="guild-name"
+                  className="block text-sm font-medium text-gray-700 dark:text-gray-300 mb-1.5"
+                >
+                  Guild Name
+                </label>
+                <input
+                  id="guild-name"
+                  type="text"
+                  defaultValue="Stellar Builders Guild"
+                  className="w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 dark:border-gray-600 dark:bg-gray-800 dark:text-white"
+                />
+              </div>
+
+              <div>
+                <label
+                  htmlFor="guild-desc"
+                  className="block text-sm font-medium text-gray-700 dark:text-gray-300 mb-1.5"
+                >
+                  Description
+                </label>
+                <textarea
+                  id="guild-desc"
+                  rows={3}
+                  defaultValue="A community of Stellar ecosystem builders."
+                  className="w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 dark:border-gray-600 dark:bg-gray-800 dark:text-white"
+                />
+              </div>
+
+              <div className="flex justify-end pt-2">
+                <button className="px-4 py-2 bg-blue-600 text-white text-sm font-medium rounded-lg hover:bg-blue-700 transition-colors">
+                  Save Changes
+                </button>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </SettingsLayout>
+  );
+}
diff --git a/frontend/src/components/guild/SettingsLayout.tsx b/frontend/src/components/guild/SettingsLayout.tsx
new file mode 100644
index 0000000..0869e8b
--- /dev/null
+++ b/frontend/src/components/guild/SettingsLayout.tsx
@@ -0,0 +1,137 @@
+'use client';
+
+import React, { useState } from 'react';
+import Link from 'next/link';
+import { usePathname } from 'next/navigation';
+import {
+  Settings,
+  Users,
+  Wallet,
+  Plug,
+  Menu,
+  X,
+} from 'lucide-react';
+import { cn } from '@/lib/utils';
+
+interface SettingsNavItem {
+  id: string;
+  label: string;
+  href: string;
+  icon: React.ReactNode;
+}
+
+const settingsNavItems: SettingsNavItem[] = [
+  { id: 'general', label: 'General', href: '/guilds/[id]/settings/general', icon: <Settings size={18} /> },
+  { id: 'members', label: 'Members', href: '/guilds/[id]/settings/members', icon: <Users size={18} /> },
+  { id: 'treasury', label: 'Treasury', href: '/guilds/[id]/settings/treasury', icon: <Wallet size={18} /> },
+  { id: 'integrations', label: 'Integrations', href: '/guilds/[id]/settings/integrations', icon: <Plug size={18} /> },
+];
+
+interface SettingsLayoutProps {
+  children: React.ReactNode;
+  /** Optional guild name for the header */
+  guildName?: string;
+}
+
+/**
+ * Guild Settings Layout
+ *
+ * Dashboard shell for Guild Admin management.
+ * Persistent left sidebar with navigation links and a central content area.
+ * Sidebar collapses into a hamburger menu on mobile (md breakpoint and below).
+ */
+export function SettingsLayout({
+  children,
+  guildName = 'Guild Settings',
+}: SettingsLayoutProps): JSX.Element {
+  const [sidebarOpen, setSidebarOpen] = useState(false);
+  const pathname = usePathname();
+
+  const isActive = (href: string) => {
+    // Simple matching for demo — in production this uses route params
+    const segment = href.split('/').pop();
+    return pathname?.includes(segment ?? '');
+  };
+
+  return (
+    <div className="flex min-h-screen bg-gray-50 dark:bg-gray-950">
+      {/* Mobile overlay */}
+      {sidebarOpen && (
+        <div
+          className="fixed inset-0 z-40 bg-black/50 md:hidden"
+          onClick={() => setSidebarOpen(false)}
+          aria-hidden="true"
+        />
+      )}
+
+      {/* Sidebar */}
+      <aside
+        className={cn(
+          'fixed inset-y-0 left-0 z-50 flex w-64 flex-col border-r border-gray-200 bg-white transition-transform duration-200 md:static md:translate-x-0 dark:border-gray-800 dark:bg-gray-900',
+          sidebarOpen ? 'translate-x-0' : '-translate-x-full',
+        )}
+      >
+        {/* Sidebar header */}
+        <div className="flex h-16 items-center justify-between px-5 border-b border-gray-100 dark:border-gray-800">
+          <h2 className="text-base font-semibold text-gray-900 dark:text-white truncate">
+            {guildName}
+          </h2>
+          <button
+            onClick={() => setSidebarOpen(false)}
+            className="rounded-md p-1.5 text-gray-400 hover:text-gray-600 md:hidden"
+            aria-label="Close sidebar"
+          >
+            <X size={18} />
+          </button>
+        </div>
+
+        {/* Navigation links */}
+        <nav className="flex-1 space-y-1 p-3" aria-label="Settings navigation">
+          {settingsNavItems.map((item) => (
+            <Link
+              key={item.id}
+              href={item.href}
+              onClick={() => setSidebarOpen(false)}
+              className={cn(
+                'flex items-center gap-3 rounded-lg px-3 py-2.5 text-sm font-medium transition-colors',
+                isActive(item.href)
+                  ? 'bg-blue-50 text-blue-700 dark:bg-blue-900/20 dark:text-blue-400'
+                  : 'text-gray-600 hover:bg-gray-100 hover:text-gray-900 dark:text-gray-400 dark:hover:bg-gray-800 dark:hover:text-gray-200',
+              )}
+            >
+              {item.icon}
+              {item.label}
+            </Link>
+          ))}
+        </nav>
+
+        {/* Sidebar footer */}
+        <div className="border-t border-gray-100 p-4 dark:border-gray-800">
+          <p className="text-xs text-gray-400 dark:text-gray-500">
+            Guild Admin Panel
+          </p>
+        </div>
+      </aside>
+
+      {/* Main content area */}
+      <div className="flex flex-1 flex-col">
+        {/* Top bar (mobile hamburger) */}
+        <header className="flex h-16 items-center gap-3 border-b border-gray-200 bg-white px-4 dark:border-gray-800 dark:bg-gray-900 md:hidden">
+          <button
+            onClick={() => setSidebarOpen(true)}
+            className="rounded-md p-2 text-gray-600 hover:bg-gray-100 dark:text-gray-400 dark:hover:bg-gray-800"
+            aria-label="Open sidebar"
+          >
+            <Menu size={20} />
+          </button>
+          <h1 className="text-base font-semibold text-gray-900 dark:text-white truncate">
+            {guildName}
+          </h1>
+        </header>
+
+        {/* Content */}
+        <main className="flex-1 p-6">{children}</main>
+      </div>
+    </div>
+  );
+}
diff --git a/frontend/src/components/guild/index.ts b/frontend/src/components/guild/index.ts
index e5f4791..09b87a2 100644
--- a/frontend/src/components/guild/index.ts
+++ b/frontend/src/components/guild/index.ts
@@ -1,2 +1,5 @@
 export { default as GuildCard } from './GuildCard'
-export type { GuildTier } from './GuildCard'
\ No newline at end of file
+export type { GuildTier } from './GuildCard'
+export { RoleBadge } from './RoleBadge'
+export type { GuildRole } from './RoleBadge'
+export { SettingsLayout } from './SettingsLayout'
\ No newline at end of file