Initial commit

Made-with: Cursor

.gitignore

+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+*storybook.log
+storybook-static

.storybook/main.ts

+import type { StorybookConfig } from '@storybook/nextjs';
+
+const config: StorybookConfig = {
+  "stories": [
+    "../stories/**/*.mdx",
+    "../stories/**/*.stories.@(js|jsx|mjs|ts|tsx)"
+  ],
+  "addons": [
+    "@storybook/addon-a11y",
+    "@storybook/addon-docs",
+    "@storybook/addon-onboarding"
+  ],
+  "framework": "@storybook/nextjs",
+  "staticDirs": [
+    "../public"
+  ]
+};
+export default config;
\ No newline at end of file

.storybook/preview.ts

+import type { Preview } from '@storybook/nextjs'
+
+const preview: Preview = {
+  parameters: {
+    controls: {
+      matchers: {
+       color: /(background|color)$/i,
+       date: /Date$/i,
+      },
+    },
+  },
+};
+
+export default preview;
\ No newline at end of file

AGENTS.md

+<!-- BEGIN:nextjs-agent-rules -->
+# This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
+<!-- END:nextjs-agent-rules -->

CLAUDE.md

+@AGENTS.md

README.md

+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

app/globals.css

+@import "tailwindcss";
+
+/* Load original MAF-UIS CSS selectors so class-based markup matches pixel-for-pixel. */
+@import "../../maf-uis/maf-ui/css/main.css";
+
+:root {
+  /* Brand */
+  --maroon: #8b1538;
+  --maroon-deep: #6b0f2a;
+  --maroon-bright: #a91d47;
+  --gold: #c9a961;
+  --gold-light: #dfc07a;
+  --gold-pale: rgba(201, 169, 97, 0.12);
+  --gold-border: rgba(201, 169, 97, 0.2);
+  --gold-border-strong: rgba(201, 169, 97, 0.45);
+
+  /* Neutrals — professional contrast */
+  --ink: #0a0a0c;
+  --ink-2: #121214;
+  --ink-3: #1a1a1d;
+  --ink-4: #27272a;
+  --text-1: #fafafa;
+  --text-2: #a1a1aa;
+  --text-3: #71717a;
+  --white: rgba(255, 255, 255, 0.06);
+  --white-2: rgba(255, 255, 255, 0.1);
+
+  /* Surfaces (semantic) */
+  --surface-base: var(--ink);
+  --surface-raised: var(--ink-2);
+  --surface-overlay: var(--ink-3);
+  --border-subtle: var(--gold-border);
+  --border-strong: var(--gold-border-strong);
+
+  /* Status */
+  --status-new: #3b82f6;
+  --status-incomplete: #eab308;
+  --status-inprogress: #3b82f6;
+  --status-completed: #22c55e;
+  --status-published: #22c55e;
+  --status-active: #22c55e;
+  --status-blocked: #ef4444;
+  --status-draft: #94a3b8;
+  --notif-info: #3b82f6;
+  --notif-success: #22c55e;
+  --notif-warning: #f59e0b;
+  --notif-action: #8b1538;
+
+  /* Typography — MAF theme: professional scale & fonts */
+  --font-display: "Cormorant Garamond", Georgia, serif;
+  --font-sans: "Syne", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  --font-mono: "JetBrains Mono", "SF Mono", Consolas, monospace;
+  /* Aliases used for Tailwind @theme token mapping (avoid self-references) */
+  --maf-font-sans: var(--font-sans);
+  --maf-font-mono: var(--font-mono);
+  --text-xs: 0.75rem; /* 12px */
+  --text-sm: 0.8125rem; /* 13px */
+  --text-base: 0.9375rem; /* 15px */
+  --text-md: 1rem; /* 16px */
+  --text-lg: 1.125rem; /* 18px */
+  --text-xl: 1.25rem; /* 20px */
+  --text-2xl: 1.5rem; /* 24px */
+  --text-3xl: 1.875rem; /* 30px */
+  --leading-tight: 1.25;
+  --leading-snug: 1.375;
+  --leading-normal: 1.5;
+  --leading-relaxed: 1.625;
+  --tracking-tight: -0.02em;
+  --tracking-normal: 0;
+  --tracking-wide: 0.05em;
+  --tracking-wider: 0.08em;
+  --font-weight-medium: 500;
+  --font-weight-semibold: 600;
+  --font-weight-bold: 700;
+
+  /* Spacing scale (4px base) */
+  --space-1: 4px;
+  --space-2: 8px;
+  --space-3: 12px;
+  --space-4: 16px;
+  --space-5: 20px;
+  --space-6: 24px;
+  --space-8: 32px;
+  --space-10: 40px;
+  --space-12: 48px;
+  --space-16: 64px;
+
+  /* Shadows */
+  --shadow-maroon: 0 8px 32px rgba(139, 21, 56, 0.4);
+  --shadow-deep: 0 24px 64px rgba(0, 0, 0, 0.6);
+  --shadow-focus: 0 0 0 3px rgba(201, 169, 97, 0.3);
+  --shadow-toast: 0 10px 40px rgba(0, 0, 0, 0.5);
+
+  /* Motion */
+  --ease: cubic-bezier(0.22, 1, 0.36, 1);
+  --ease-out: cubic-bezier(0.33, 1, 0.68, 1);
+  --t1: 0.12s;
+  --t2: 0.22s;
+  --t3: 0.35s;
+
+  /* Layout */
+  --header-height: 56px;
+  --sidebar-width: 240px;
+  --sidebar-width-collapsed: 72px;
+  --bottom-nav-height: 64px;
+  --compact-footer-height: 48px;
+  --notif-panel-width: 380px;
+  --notif-panel-max-height: 85vh;
+  --content-max-width: 1280px;
+
+  /* Radius */
+  --r-sm: 8px;
+  --r-md: 14px;
+  --r-lg: 20px;
+  --r-full: 9999px;
+
+  /* Touch targets */
+  --touch-min: 44px;
+}
+
+/* Light theme overrides (triggered by `data-theme="light"`) */
+html[data-theme="light"] {
+  --ink: #f8f9fa;
+  --ink-2: #ffffff;
+  --ink-3: #f1f3f5;
+  --ink-4: #e9ecef;
+  --text-1: #1a1d21;
+  --text-2: #495057;
+  --text-3: #868e96;
+  --white: rgba(0, 0, 0, 0.04);
+  --white-2: rgba(0, 0, 0, 0.08);
+  --surface-base: #f8f9fa;
+  --surface-raised: #ffffff;
+  --surface-overlay: #ffffff;
+  --border-subtle: rgba(139, 21, 56, 0.15);
+  --border-strong: rgba(139, 21, 56, 0.35);
+  --gold-border: rgba(201, 169, 97, 0.35);
+  --gold-border-strong: rgba(201, 169, 97, 0.55);
+  --gold-pale: rgba(201, 169, 97, 0.12);
+  --shadow-deep: 0 24px 64px rgba(0, 0, 0, 0.08);
+  --shadow-toast: 0 10px 40px rgba(0, 0, 0, 0.12);
+}
+
+@theme inline {
+  --font-sans: var(--maf-font-sans);
+  --font-mono: var(--maf-font-mono);
+
+  /* Semantic colors */
+  --color-ink: var(--ink);
+  --color-surface-base: var(--surface-base);
+  --color-surface-raised: var(--surface-raised);
+  --color-surface-overlay: var(--surface-overlay);
+  --color-text-1: var(--text-1);
+  --color-text-2: var(--text-2);
+  --color-text-3: var(--text-3);
+  --color-gold: var(--gold);
+  --color-gold-border: var(--gold-border);
+  --color-gold-border-strong: var(--gold-border-strong);
+  --color-gold-pale: var(--gold-pale);
+  --color-maroon: var(--maroon);
+  --color-maroon-bright: var(--maroon-bright);
+  --color-border-subtle: var(--border-subtle);
+  --color-border-strong: var(--border-strong);
+  --color-status-new: var(--status-new);
+  --color-status-incomplete: var(--status-incomplete);
+  --color-status-inprogress: var(--status-inprogress);
+  --color-status-completed: var(--status-completed);
+  --color-status-active: var(--status-active);
+  --color-status-blocked: var(--status-blocked);
+  --color-status-draft: var(--status-draft);
+}
+
+html {
+  scroll-behavior: smooth;
+  font-size: 16px;
+  overflow-x: hidden;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  html {
+    scroll-behavior: auto;
+  }
+  *, *::before, *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+  }
+}
+
+/* Basic MAF base (trimmed from MAF-UIS base.css) */
+*,
+*::before,
+*::after {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  font-family: var(--font-sans);
+  font-size: var(--text-base);
+  font-weight: 500;
+  line-height: var(--leading-normal);
+  letter-spacing: 0.01em;
+  background: var(--ink);
+  color: var(--text-1);
+  min-height: 100vh;
+  padding-top: var(--header-height);
+  padding-bottom: var(--bottom-nav-height);
+  padding-left: env(safe-area-inset-left);
+  padding-right: env(safe-area-inset-right);
+  overflow-x: hidden;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  text-rendering: optimizeLegibility;
+}
+
+:root[data-theme="light"] {
+  /* keep for older CSS selectors if needed later */
+}
+
+*:focus-visible {
+  outline: 2px solid var(--gold);
+  outline-offset: 2px;
+  box-shadow: none;
+}
+
+a:focus-visible,
+button:focus-visible {
+  box-shadow: var(--shadow-focus);
+}
+
+/* Grain overlay (from MAF-UIS) */
+html[data-theme="light"] body::before {
+  opacity: 0.15;
+}
+
+body::before {
+  content: '';
+  position: fixed;
+  inset: 0;
+  background-image: url("data:image/svg+xml,%3Csvg viewBox='0 0 256 256' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='noise'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.9' numOctaves='4' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23noise)' opacity='0.04'/%3E%3C/svg%3E");
+  pointer-events: none;
+  z-index: 9999;
+  opacity: 0.4;
+}

app/incidents/page.tsx

+'use client';
+
+import { useRouter } from 'next/navigation';
+
+import MafRequireAuth from '@/src/maf-ui/auth/MafRequireAuth';
+import MafAppShell from '@/src/maf-ui/shell/MafAppShell';
+import MafBadge from '@/src/maf-ui/components/MafBadge';
+import MafButton from '@/src/maf-ui/components/MafButton';
+import { MafCard } from '@/src/maf-ui/components/MafCard';
+
+function viewToPath(view: string) {
+  switch (view) {
+    case 'modules':
+      return '/modules';
+    case 'incidents':
+      return '/incidents';
+    case 'permit':
+      return '/permit';
+    case 'settings':
+      return '/settings';
+    case 'profile':
+      return '/profile';
+    case 'notification-center':
+      return '/notification-center';
+    case 'welcome':
+    default:
+      return '/';
+  }
+}
+
+export default function IncidentsPage() {
+  const router = useRouter();
+
+  return (
+    <MafRequireAuth
+      fallbackAccountType="employee"
+      render={(user) => (
+        <MafAppShell user={user} activeView="incidents" onNavigate={(next) => router.push(viewToPath(next))}>
+          <div className="w-full max-w-[980px] mx-auto px-3 md:px-6 py-6">
+            <MafCard className="p-6 md:p-8">
+              <div className="flex items-start justify-between gap-4">
+                <div>
+                  <h1
+                    className="text-[var(--text-3xl)] leading-[var(--leading-tight)] tracking-[var(--tracking-tight)] font-semibold text-text-1"
+                    style={{ fontFamily: 'var(--font-display)' }}
+                  >
+                    Incidents
+                  </h1>
+                  <p className="text-text-2 text-sm leading-[var(--leading-relaxed)] mt-2">
+                    Placeholder list view that confirms cards/buttons/badges styling on the shell.
+                  </p>
+                </div>
+                <MafBadge tone="warning">3 pending</MafBadge>
+              </div>
+
+              <div className="mt-6 space-y-3">
+                <div className="rounded-[var(--r-md)] border border-gold-border bg-[var(--ink-2)] p-4">
+                  <div className="flex items-center justify-between gap-3">
+                    <div>
+                      <div className="text-text-1 font-semibold">Incident #INC-2024-001</div>
+                      <div className="text-text-3 text-xs uppercase tracking-[0.06em] mt-1">
+                        Open · Requires review
+                      </div>
+                    </div>
+                    <MafBadge tone="info">1 day</MafBadge>
+                  </div>
+                  <div className="mt-3 flex gap-3 flex-wrap">
+                    <MafButton variant="primary" size="small" onClick={() => {}}>
+                      Review
+                    </MafButton>
+                    <MafButton variant="ghost" size="small" onClick={() => {}}>
+                      Assign
+                    </MafButton>
+                  </div>
+                </div>
+
+                <div className="rounded-[var(--r-md)] border border-gold-border bg-[var(--ink-2)] p-4">
+                  <div className="flex items-center justify-between gap-3">
+                    <div>
+                      <div className="text-text-1 font-semibold">Incident #INC-2024-014</div>
+                      <div className="text-text-3 text-xs uppercase tracking-[0.06em] mt-1">
+                        Open · Pending approval
+                      </div>
+                    </div>
+                    <MafBadge tone="draft">Draft</MafBadge>
+                  </div>
+                  <div className="mt-3 flex gap-3 flex-wrap">
+                    <MafButton variant="primary" size="small" onClick={() => {}}>
+                      Approve
+                    </MafButton>
+                    <MafButton variant="ghost" size="small" onClick={() => {}}>
+                      View
+                    </MafButton>
+                  </div>
+                </div>
+              </div>
+            </MafCard>
+          </div>
+        </MafAppShell>
+      )}
+    />
+  );
+}
+

app/layout.tsx

+import type { Metadata } from "next";
+import { Cormorant_Garamond, JetBrains_Mono, Syne } from "next/font/google";
+import "./globals.css";
+
+const cormorant = Cormorant_Garamond({
+  subsets: ["latin"],
+  weight: ["400", "500", "600", "700"],
+  variable: "--font-maf-display",
+});
+
+const syne = Syne({
+  subsets: ["latin"],
+  weight: ["400", "500", "600", "700", "800"],
+  variable: "--font-maf-sans",
+});
+
+const jetbrainsMono = JetBrains_Mono({
+  subsets: ["latin"],
+  weight: ["400", "500"],
+  variable: "--font-maf-mono",
+});
+
+export const metadata: Metadata = {
+  title: "MAF Revamp",
+  description: "MAF-UIS styled frontend",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html
+      lang="en"
+      data-theme="dark"
+      className={`${cormorant.variable} ${syne.variable} ${jetbrainsMono.variable} h-full antialiased`}
+    >
+      <body className="min-h-full flex flex-col">{children}</body>
+    </html>
+  );
+}

app/modules/page.tsx

+'use client';
+
+import { useRouter } from 'next/navigation';
+
+import MafRequireAuth from '@/src/maf-ui/auth/MafRequireAuth';
+import MafAppShell from '@/src/maf-ui/shell/MafAppShell';
+import MafButton from '@/src/maf-ui/components/MafButton';
+import MafBadge from '@/src/maf-ui/components/MafBadge';
+import MafTabs from '@/src/maf-ui/components/MafTabs';
+import { MafCard } from '@/src/maf-ui/components/MafCard';
+
+function viewToPath(view: string) {
+  switch (view) {
+    case 'modules':
+      return '/modules';
+    case 'incidents':
+      return '/incidents';
+    case 'permit':
+      return '/permit';
+    case 'settings':
+      return '/settings';
+    case 'profile':
+      return '/profile';
+    case 'notification-center':
+      return '/notification-center';
+    case 'welcome':
+    default:
+      return '/';
+  }
+}
+
+export default function ModulesPage() {
+  const router = useRouter();
+
+  return (
+    <MafRequireAuth
+      fallbackAccountType="employee"
+      render={(user) => (
+        <MafAppShell user={user} activeView="modules" onNavigate={(next) => router.push(viewToPath(next))}>
+          <div className="w-full max-w-[980px] mx-auto px-3 md:px-6 py-6">
+            <MafCard className="p-6 md:p-8">
+              <div className="flex items-start justify-between gap-4">
+                <div>
+                  <h1
+                    className="text-[var(--text-3xl)] leading-[var(--leading-tight)] tracking-[var(--tracking-tight)] font-semibold text-text-1"
+                    style={{ fontFamily: 'var(--font-display)' }}
+                  >
+                    Modules
+                  </h1>
+                  <p className="text-text-2 text-sm leading-[var(--leading-relaxed)] mt-2">
+                    Component kit + shell validation on a real Next route.
+                  </p>
+                </div>
+                <MafBadge tone="info">New</MafBadge>
+              </div>
+
+              <div className="mt-6">
+                <MafTabs
+                  defaultActiveKey="overview"
+                  items={[
+                    {
+                      key: 'overview',
+                      label: 'Overview',
+                      panel: (
+                        <div className="text-text-2 text-sm leading-[var(--leading-relaxed)]">
+                          The Modules page uses <b>MAF shell</b> + <b>MAF tabs</b> + <b>MAF buttons</b>.
+                          <div className="mt-4 flex flex-wrap gap-3">
+                            <MafButton variant="primary" onClick={() => {}}>
+                              Primary action
+                            </MafButton>
+                            <MafButton variant="ghost" onClick={() => {}}>
+                              Secondary
+                            </MafButton>
+                          </div>
+                        </div>
+                      ),
+                    },
+                    {
+                      key: 'rules',
+                      label: 'Rules',
+                      panel: <div className="text-text-2 text-sm">Rules configuration placeholder.</div>,
+                    },
+                    {
+                      key: 'approvals',
+                      label: 'Approvals',
+                      panel: (
+                        <div className="text-text-2 text-sm">
+                          Approval workflow placeholder. Use <MafBadge tone="success">Ready</MafBadge> to represent status.
+                        </div>
+                      ),
+                    },
+                  ]}
+                />
+              </div>
+            </MafCard>
+          </div>
+        </MafAppShell>
+      )}
+    />
+  );
+}
+

app/notification-center/page.tsx

+'use client';
+
+import { useRouter } from 'next/navigation';
+
+import MafRequireAuth from '@/src/maf-ui/auth/MafRequireAuth';
+import MafAppShell from '@/src/maf-ui/shell/MafAppShell';
+import MafBadge from '@/src/maf-ui/components/MafBadge';
+import MafButton from '@/src/maf-ui/components/MafButton';
+import { MafCard } from '@/src/maf-ui/components/MafCard';
+import MafNotificationCenter from '@/src/maf-ui/shell/MafNotificationCenter';
+
+function viewToPath(view: string) {
+  switch (view) {
+    case 'modules':
+      return '/modules';
+    case 'incidents':
+      return '/incidents';
+    case 'permit':
+      return '/permit';
+    case 'settings':
+      return '/settings';
+    case 'profile':
+      return '/profile';
+    case 'notification-center':
+      return '/notification-center';
+    case 'welcome':
+    default:
+      return '/';
+  }
+}
+
+export default function NotificationCenterPage() {
+  const router = useRouter();
+
+  return (
+    <MafRequireAuth
+      fallbackAccountType="employee"
+      render={(user) => (
+        <MafAppShell
+          user={user}
+          activeView="notification-center"
+          onNavigate={(next) => router.push(viewToPath(next))}
+        >
+          <div className="w-full max-w-[980px] mx-auto px-3 md:px-6 py-6">
+            <MafCard className="p-6 md:p-8">
+              <MafNotificationCenter
+                open
+                variant="page"
+                unreadCount={0}
+                onUnreadCountChange={() => {}}
+                onClose={() => {}}
+                onNavigate={(link) => {
+                  const view = (() => {
+                    switch (link) {
+                      case '#incidents':
+                        return 'incidents';
+                      case '#inspection':
+                        return 'modules';
+                      case '#admin':
+                        return 'modules';
+                      case '#profile':
+                        return 'profile';
+                      case '#settings':
+                        return 'settings';
+                      default:
+                        return 'modules';
+                    }
+                  })();
+                  router.push(viewToPath(view));
+                }}
+              />
+            </MafCard>
+          </div>
+        </MafAppShell>
+      )}
+    />
+  );
+}
+

app/page.tsx

+'use client';
+
+import { useEffect } from 'react';
+import { useRouter } from 'next/navigation';
+
+import MafGatewayLanding from '@/src/maf-ui/landing/MafGatewayLanding';
+import useAuth from '@/src/maf-ui/auth/useAuth';
+import type { MafUser } from '@/src/maf-ui/shell/MafUserMenu';
+
+export default function Home() {
+  const router = useRouter();
+  const { status, user, login } = useAuth();
+
+  useEffect(() => {
+    if (status === 'authed' && user) {
+      router.replace('/modules');
+    }
+  }, [status, user, router]);
+
+  if (status === 'authed') {
+    return null;
+  }
+
+  const handleLogin = (u: MafUser) => {
+    login({
+      email: `${u.name}@company.com`,
+      accountType: u.role === 'Admin' ? 'employee' : 'contractor',
+    });
+    router.replace('/modules');
+  };
+
+  return <MafGatewayLanding onLoginSuccess={handleLogin} />;
+}

app/permit/page.tsx

+'use client';
+
+import { useRouter } from 'next/navigation';
+
+import MafRequireAuth from '@/src/maf-ui/auth/MafRequireAuth';
+import MafAppShell from '@/src/maf-ui/shell/MafAppShell';
+import MafButton from '@/src/maf-ui/components/MafButton';
+import { MafCard } from '@/src/maf-ui/components/MafCard';
+
+function viewToPath(view: string) {
+  switch (view) {
+    case 'modules':
+      return '/modules';
+    case 'incidents':
+      return '/incidents';
+    case 'permit':
+      return '/permit';
+    case 'settings':
+      return '/settings';
+    case 'profile':
+      return '/profile';
+    case 'notification-center':
+      return '/notification-center';
+    case 'welcome':
+    default:
+      return '/';
+  }
+}
+
+export default function PermitPage() {
+  const router = useRouter();
+
+  return (
+    <MafRequireAuth
+      fallbackAccountType="employee"
+      render={(user) => (
+        <MafAppShell user={user} activeView="permit" onNavigate={(next) => router.push(viewToPath(next))}>
+          <div className="w-full max-w-[980px] mx-auto px-3 md:px-6 py-6">
+            <MafCard className="p-6 md:p-8">
+              <h1
+                className="text-[var(--text-3xl)] leading-[var(--leading-tight)] tracking-[var(--tracking-tight)] font-semibold text-text-1"
+                style={{ fontFamily: 'var(--font-display)' }}
+              >
+                Permit
+              </h1>
+              <p className="text-text-2 text-sm leading-[var(--leading-relaxed)] mt-2">
+                Placeholder route to confirm shell layout across navigation.
+              </p>
+
+              <div className="mt-6">
+                <MafButton variant="primary" onClick={() => {}}>
+                  Create permit
+                </MafButton>
+              </div>
+            </MafCard>
+          </div>
+        </MafAppShell>
+      )}
+    />
+  );
+}
+

app/profile/page.tsx

+'use client';
+
+import { useRouter } from 'next/navigation';
+
+import MafRequireAuth from '@/src/maf-ui/auth/MafRequireAuth';
+import MafAppShell from '@/src/maf-ui/shell/MafAppShell';
+import MafButton from '@/src/maf-ui/components/MafButton';
+import { MafCard } from '@/src/maf-ui/components/MafCard';
+
+function viewToPath(view: string) {
+  switch (view) {
+    case 'modules':
+      return '/modules';
+    case 'incidents':
+      return '/incidents';
+    case 'permit':
+      return '/permit';
+    case 'settings':
+      return '/settings';
+    case 'profile':
+      return '/profile';
+    case 'notification-center':
+      return '/notification-center';
+    case 'welcome':
+    default:
+      return '/';
+  }
+}
+
+export default function ProfilePage() {
+  const router = useRouter();
+
+  return (
+    <MafRequireAuth
+      fallbackAccountType="employee"
+      render={(user) => (
+        <MafAppShell user={user} activeView="profile" onNavigate={(next) => router.push(viewToPath(next))}>
+          <div className="w-full max-w-[980px] mx-auto px-3 md:px-6 py-6">
+            <MafCard className="p-6 md:p-8">
+              <h1
+                className="text-[var(--text-3xl)] leading-[var(--leading-tight)] tracking-[var(--tracking-tight)] font-semibold text-text-1"
+                style={{ fontFamily: 'var(--font-display)' }}
+              >
+                Profile
+              </h1>
+              <p className="text-text-2 text-sm leading-[var(--leading-relaxed)] mt-2">
+                Placeholder route to validate header + user menu + shell spacing.
+              </p>
+
+              <div className="mt-6">
+                <MafButton variant="primary" onClick={() => {}}>
+                  Edit profile
+                </MafButton>
+              </div>
+            </MafCard>
+          </div>
+        </MafAppShell>
+      )}
+    />
+  );
+}
+

app/settings/page.tsx

+'use client';
+
+import { useRouter } from 'next/navigation';
+
+import MafRequireAuth from '@/src/maf-ui/auth/MafRequireAuth';
+import MafAppShell from '@/src/maf-ui/shell/MafAppShell';
+import MafButton from '@/src/maf-ui/components/MafButton';
+import { MafCard } from '@/src/maf-ui/components/MafCard';
+import MafBadge from '@/src/maf-ui/components/MafBadge';
+
+function viewToPath(view: string) {
+  switch (view) {
+    case 'modules':
+      return '/modules';
+    case 'incidents':
+      return '/incidents';
+    case 'permit':
+      return '/permit';
+    case 'settings':
+      return '/settings';
+    case 'profile':
+      return '/profile';
+    case 'notification-center':
+      return '/notification-center';
+    case 'welcome':
+    default:
+      return '/';
+  }
+}
+
+export default function SettingsPage() {
+  const router = useRouter();
+
+  return (
+    <MafRequireAuth
+      fallbackAccountType="employee"
+      render={(user) => (
+        <MafAppShell user={user} activeView="settings" onNavigate={(next) => router.push(viewToPath(next))}>
+          <div className="w-full max-w-[980px] mx-auto px-3 md:px-6 py-6">
+            <MafCard className="p-6 md:p-8">
+              <div className="flex items-start justify-between gap-4">
+                <div>
+                  <h1
+                    className="text-[var(--text-3xl)] leading-[var(--leading-tight)] tracking-[var(--tracking-tight)] font-semibold text-text-1"
+                    style={{ fontFamily: 'var(--font-display)' }}
+                  >
+                    Settings
+                  </h1>
+                  <p className="text-text-2 text-sm leading-[var(--leading-relaxed)] mt-2">
+                    Placeholder page for settings UI and navigation validation.
+                  </p>
+                </div>
+                <MafBadge tone="draft">Demo</MafBadge>
+              </div>
+
+              <div className="mt-6 flex gap-3 flex-wrap">
+                <MafButton variant="primary" onClick={() => {}}>
+                  Save changes
+                </MafButton>
+                <MafButton variant="ghost" onClick={() => {}}>
+                  Reset
+                </MafButton>
+              </div>
+            </MafCard>
+          </div>
+        </MafAppShell>
+      )}
+    />
+  );
+}
+

eslint.config.mjs

+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

next.config.ts

+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;

package.json

+{
+  "name": "maf-revamp-frontend",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build"
+  },
+  "dependencies": {
+    "next": "16.2.0",
+    "react": "19.2.4",
+    "react-dom": "19.2.4"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.2.0",
+    "tailwindcss": "^4",
+    "typescript": "^5",
+    "storybook": "^10.3.1",
+    "@storybook/nextjs": "^10.3.1",
+    "@storybook/addon-a11y": "^10.3.1",
+    "@storybook/addon-docs": "^10.3.1",
+    "@storybook/addon-onboarding": "^10.3.1"
+  }
+}

pnpm-workspace.yaml

+ignoredBuiltDependencies:
+  - sharp
+  - unrs-resolver

postcss.config.mjs

+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

public/file.svg

+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>
\ No newline at end of file

public/globe.svg

+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>
\ No newline at end of file

public/next.svg

+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>
\ No newline at end of file

public/vercel.svg

+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>
\ No newline at end of file

public/window.svg

+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>
\ No newline at end of file

src/maf-ui/auth/MafLoginModal.tsx

+// MAF-styled login dialog (mock auth).
+'use client';
+
+import { FormEvent, useEffect, useMemo, useRef, useState } from 'react';
+
+import MafButton from '@/src/maf-ui/components/MafButton';
+import { MafCard } from '@/src/maf-ui/components/MafCard';
+
+import type { MafUser } from '@/src/maf-ui/shell/MafUserMenu';
+
+export default function MafLoginModal({
+  open,
+  defaultAccountType = 'employee',
+  onClose,
+  onSuccess,
+}: {
+  open: boolean;
+  defaultAccountType?: 'employee' | 'contractor';
+  onClose?: () => void;
+  onSuccess: (user: MafUser) => void;
+}) {
+  const [accountType, setAccountType] = useState<'employee' | 'contractor'>(defaultAccountType);
+  const [email, setEmail] = useState('');
+  const [password, setPassword] = useState('');
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const emailRef = useRef<HTMLInputElement | null>(null);
+
+  useEffect(() => {
+    if (!open) return;
+    setAccountType(defaultAccountType);
+    setError(null);
+    setLoading(false);
+    // focus first field for accessibility.
+    setTimeout(() => emailRef.current?.focus(), 0);
+  }, [open, defaultAccountType]);
+
+  useEffect(() => {
+    if (!open) return;
+    const onKeyDown = (e: KeyboardEvent) => {
+      if (e.key === 'Escape') onClose?.();
+    };
+    document.addEventListener('keydown', onKeyDown);
+    // Prevent background scroll.
+    const prev = document.body.style.overflow;
+    document.body.style.overflow = 'hidden';
+    return () => {
+      document.removeEventListener('keydown', onKeyDown);
+      document.body.style.overflow = prev;
+    };
+  }, [open, onClose]);
+
+  const tabDefs = useMemo(
+    () => [
+      { key: 'employee' as const, label: 'MAF Employee' },
+      { key: 'contractor' as const, label: 'Contractor / Supplier' },
+    ],
+    []
+  );
+
+  if (!open) return null;
+
+  const submit = async (e: FormEvent) => {
+    e.preventDefault();
+    if (!email.trim()) {
+      setError('Please enter your email.');
+      return;
+    }
+    if (!password.trim()) {
+      setError('Password is required.');
+      return;
+    }
+
+    setLoading(true);
+    setError(null);
+    // Mock latency to mimic UX.
+    await new Promise((r) => setTimeout(r, 600));
+
+    const base = (email.split('@')[0] || email).replace(/[^a-zA-Z0-9]/g, '');
+    const initials = (base.slice(0, 2).toUpperCase() || 'MAF').padEnd(2, 'F');
+    const user: MafUser = {
+      initials,
+      name: email.includes('@') ? email.split('@')[0] : email,
+      role: accountType === 'employee' ? 'Admin' : 'Contractor',
+    };
+
+    setLoading(false);
+    onSuccess(user);
+    onClose?.();
+  };
+
+  return (
+    <div
+      className="fixed inset-0 z-[2000] bg-black/60 flex items-center justify-center p-4"
+      role="dialog"
+      aria-modal="true"
+      aria-label="Login"
+    >
+      <div className="absolute inset-0" onClick={onClose} aria-hidden="true" />
+
+      <MafCard className="relative w-full max-w-[560px] p-5 md:p-7">
+        <div className="flex items-start justify-between gap-4 mb-4">
+          <div>
+            <h2
+              className="text-[1.65rem] leading-tight font-semibold text-text-1"
+              style={{ fontFamily: 'var(--font-display)' }}
+            >
+              Welcome back
+            </h2>
+            <p className="text-text-2 text-sm mt-1 font-medium">Choose your account type to continue</p>
+          </div>
+          <button
+            type="button"
+            className="w-10 h-10 rounded-[var(--r-sm)] border border-gold-border bg-white/0 hover:bg-white/5 text-text-2"
+            aria-label="Close login dialog"
+            onClick={onClose}
+          >
+            ×
+          </button>
+        </div>
+
+        <div className="mb-4 flex gap-3" role="tablist" aria-label="Login type">
+          {tabDefs.map((t) => {
+            const active = t.key === accountType;
+            return (
+              <button
+                key={t.key}
+                type="button"
+                role="tab"
+                aria-selected={active}
+                className={[
+                  'px-4 py-2 rounded-[var(--r-sm)] text-sm font-semibold border transition-colors',
+                  active ? 'bg-gold-pale border-gold-border-strong text-gold' : 'bg-surface-raised border-gold-border text-text-2 hover:text-text-1',
+                ].join(' ')}
+                onClick={() => setAccountType(t.key)}
+              >
+                {t.label}
+              </button>
+            );
+          })}
+        </div>
+
+        <form onSubmit={submit} className="space-y-4" aria-label="Sign in form">
+          <div className="space-y-2">
+            <label className="block text-text-3 text-xs uppercase tracking-[0.08em] font-semibold" htmlFor="loginEmail">
+              Company Email
+            </label>
+            <input
+              ref={emailRef}
+              id="loginEmail"
+              type="email"
+              value={email}
+              onChange={(e) => setEmail(e.target.value)}
+              placeholder="you@company.com"
+              autoComplete="email"
+              className="w-full h-[44px] px-3 rounded-[var(--r-sm)] border border-gold-border bg-surface-raised text-text-1 outline-none focus:border-gold-border-strong"
+            />
+          </div>
+
+          <div className="space-y-2">
+            <label className="block text-text-3 text-xs uppercase tracking-[0.08em] font-semibold" htmlFor="loginPassword">
+              Password
+            </label>
+            <input
+              id="loginPassword"
+              type="password"
+              value={password}
+              onChange={(e) => setPassword(e.target.value)}
+              placeholder="Your password"
+              autoComplete="current-password"
+              className="w-full h-[44px] px-3 rounded-[var(--r-sm)] border border-gold-border bg-surface-raised text-text-1 outline-none focus:border-gold-border-strong"
+            />
+          </div>
+
+          {error && (
+            <div className="text-red-400 text-sm font-semibold" role="alert">
+              {error}
+            </div>
+          )}
+
+          <div className="flex items-center justify-between gap-3">
+            <label className="flex items-center gap-2 text-text-2 text-sm select-none">
+              <input type="checkbox" className="accent-[#C9A961]" />
+              Remember me
+            </label>
+            <button
+              type="button"
+              className="text-gold text-sm font-semibold hover:opacity-90"
+              onClick={() => setError('Password reset is mocked in this demo.')}
+            >
+              Forgot password?
+            </button>
+          </div>
+
+          <div className="pt-2">
+            <MafButton variant="primary" size="medium" loading={loading} disabled={loading} className="w-full">
+              {loading ? 'Signing in...' : 'Log In'}
+            </MafButton>
+          </div>
+
+          <div className="text-text-2 text-sm pt-1">
+            Need help accessing your account?{' '}
+            <button type="button" className="text-gold font-semibold hover:opacity-90" onClick={() => setError('Support is mocked.')}>
+              Contact support →
+            </button>
+          </div>
+        </form>
+      </MafCard>
+    </div>
+  );
+}
+

src/maf-ui/auth/MafRequireAuth.tsx

+'use client';
+
+import { ReactNode } from 'react';
+
+import useAuth from '@/src/maf-ui/auth/useAuth';
+import MafLoginModal from '@/src/maf-ui/auth/MafLoginModal';
+import type { MafUser } from '@/src/maf-ui/shell/MafUserMenu';
+
+export default function MafRequireAuth({
+  render,
+  fallbackAccountType,
+}: {
+  render: (user: MafUser) => ReactNode;
+  fallbackAccountType?: 'employee' | 'contractor';
+}) {
+  const { status, user, login } = useAuth();
+
+  if (status === 'loading') {
+    // Keep layout stable while auth state initializes.
+    return null;
+  }
+
+  if (!user) {
+    return (
+      <MafLoginModal
+        open
+        defaultAccountType={fallbackAccountType ?? 'employee'}
+        onClose={() => {}}
+        onSuccess={(u) => {
+          // Ensure storage is set via hook login (we only need to route after).
+          login({
+            email: `${u.name}@company.com`,
+            accountType: u.role === 'Admin' ? 'employee' : 'contractor',
+          });
+        }}
+      />
+    );
+  }
+
+  return <>{render(user)}</>;
+}
+

src/maf-ui/auth/useAuth.ts

+'use client';
+
+import { useCallback, useEffect, useMemo, useState } from 'react';
+
+import type { MafUser } from '@/src/maf-ui/shell/MafUserMenu';
+
+export type AuthStatus = 'loading' | 'guest' | 'authed';
+
+const STORAGE_USER_KEY = 'maf_user';
+
+function safeParseUser(raw: string | null): MafUser | null {
+  if (!raw) return null;
+  try {
+    const parsed = JSON.parse(raw) as MafUser;
+    if (!parsed?.initials || !parsed?.name || !parsed?.role) return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+
+function makeInitials(email: string) {
+  const base = (email.split('@')[0] || email).replace(/[^a-zA-Z0-9]/g, '');
+  const a = base.slice(0, 2).toUpperCase();
+  return a.length ? a : 'MAF';
+}
+
+export default function useAuth() {
+  const [status, setStatus] = useState<AuthStatus>('loading');
+  const [user, setUser] = useState<MafUser | null>(null);
+
+  useEffect(() => {
+    const u = safeParseUser(localStorage.getItem(STORAGE_USER_KEY));
+    if (u) {
+      setUser(u);
+      setStatus('authed');
+    } else {
+      setUser(null);
+      setStatus('guest');
+    }
+  }, []);
+
+  const logout = useCallback(() => {
+    try {
+      localStorage.removeItem(STORAGE_USER_KEY);
+    } catch {
+      // ignore
+    }
+    setUser(null);
+    setStatus('guest');
+  }, []);
+
+  const login = useCallback((params: { email: string; accountType: 'employee' | 'contractor' }) => {
+    const email = params.email.trim();
+    const initials = makeInitials(email);
+    const nextUser: MafUser = {
+      initials,
+      name: email.includes('@') ? email.split('@')[0] : email,
+      role: params.accountType === 'employee' ? 'Admin' : 'Contractor',
+    };
+
+    try {
+      localStorage.setItem(STORAGE_USER_KEY, JSON.stringify(nextUser));
+    } catch {
+      // ignore
+    }
+    setUser(nextUser);
+    setStatus('authed');
+  }, []);
+
+  const api = useMemo(
+    () => ({
+      status,
+      user,
+      authed: status === 'authed',
+      guest: status === 'guest',
+      login,
+      logout,
+    }),
+    [status, user, login, logout]
+  );
+
+  return api;
+}
+

src/maf-ui/components/MafBadge.tsx

+import { HTMLAttributes } from 'react';
+
+export type MafBadgeTone = 'info' | 'success' | 'warning' | 'action' | 'draft';
+
+export type MafBadgeProps = {
+  tone?: MafBadgeTone;
+} & HTMLAttributes<HTMLSpanElement>;
+
+function toneClasses(tone: MafBadgeTone) {
+  switch (tone) {
+    case 'success':
+      return 'bg-[rgba(34,197,94,0.12)] border border-[rgba(34,197,94,0.25)] text-[#22c55e]';
+    case 'warning':
+      return 'bg-[rgba(245,158,11,0.12)] border border-[rgba(245,158,11,0.25)] text-[#f59e0b]';
+    case 'action':
+      return 'bg-[rgba(139,21,56,0.18)] border border-[rgba(201,169,97,0.25)] text-[#dfc07a]';
+    case 'draft':
+      return 'bg-[rgba(148,163,184,0.12)] border border-[rgba(148,163,184,0.25)] text-[#94a3b8]';
+    case 'info':
+    default:
+      return 'bg-[rgba(59,130,246,0.12)] border border-[rgba(59,130,246,0.25)] text-[#3b82f6]';
+  }
+}
+
+export default function MafBadge({ tone = 'info', className, ...rest }: MafBadgeProps) {
+  return (
+    <span
+      className={[
+        'inline-flex items-center px-3 min-h-[28px] rounded-[var(--r-sm)] text-xs font-semibold border',
+        'tracking-[0.03em]',
+        toneClasses(tone),
+        className ?? '',
+      ].join(' ')}
+      {...rest}
+    />
+  );
+}
+

src/maf-ui/components/MafButton.tsx

+import { ButtonHTMLAttributes, ReactNode } from 'react';
+
+export type MafButtonVariant = 'primary' | 'secondary' | 'ghost';
+export type MafButtonSize = 'small' | 'medium' | 'large';
+
+export type MafButtonProps = {
+  variant?: MafButtonVariant;
+  size?: MafButtonSize;
+  leftIcon?: ReactNode;
+  rightIcon?: ReactNode;
+  loading?: boolean;
+} & ButtonHTMLAttributes<HTMLButtonElement>;
+
+function sizeClasses(size: MafButtonSize) {
+  switch (size) {
+    case 'small':
+      return 'min-h-[44px] px-4 text-sm';
+    case 'large':
+      return 'min-h-[44px] px-6 text-base';
+    case 'medium':
+    default:
+      return 'min-h-[44px] px-5 text-sm';
+  }
+}
+
+function variantClasses(variant: MafButtonVariant) {
+  switch (variant) {
+    case 'primary':
+      return 'bg-gradient-to-r from-maroon to-maroon-bright text-white border-none shadow-[var(--shadow-maroon)]';
+    case 'ghost':
+      return 'bg-transparent text-gold border border-gold-border hover:bg-gold-pale hover:border-gold-border-strong';
+    case 'secondary':
+    default:
+      return 'bg-surface-raised text-text-1 border border-gold-border hover:bg-surface-overlay hover:border-gold-border-strong';
+  }
+}
+
+export default function MafButton({
+  variant = 'primary',
+  size = 'medium',
+  leftIcon,
+  rightIcon,
+  loading,
+  disabled,
+  className,
+  children,
+  ...rest
+}: MafButtonProps) {
+  const isDisabled = disabled || loading;
+
+  return (
+    <button
+      type="button"
+      disabled={isDisabled}
+      className={[
+        'inline-flex items-center justify-center gap-2 rounded-[var(--r-sm)] font-semibold transition-colors',
+        sizeClasses(size),
+        variantClasses(variant),
+        isDisabled ? 'opacity-80 cursor-not-allowed' : 'cursor-pointer',
+        className ?? '',
+      ].join(' ')}
+      {...rest}
+    >
+      {loading ? (
+        <span className="inline-flex items-center justify-center w-5 h-5 rounded-full border-2 border-white/40 border-t-white animate-spin" aria-label="Loading" />
+      ) : (
+        <>
+          {leftIcon}
+          <span>{children}</span>
+          {rightIcon}
+        </>
+      )}
+    </button>
+  );
+}
+

src/maf-ui/components/MafCard.tsx

+import { HTMLAttributes, ReactNode } from 'react';
+
+export type MafSurfaceProps = {
+  as?: 'div' | 'section' | 'article';
+  children: ReactNode;
+} & HTMLAttributes<HTMLDivElement>;
+
+export function MafSurface({ as = 'div', children, className, ...rest }: MafSurfaceProps) {
+  // Use `any` for the polymorphic element to avoid `JSX.IntrinsicElements` typing issues.
+  const Component = as as any;
+  return (
+    <Component
+      {...rest}
+      className={[
+        'rounded-[var(--r-md)] border border-gold-border bg-surface-raised text-text-1',
+        className ?? '',
+      ].join(' ')}
+    >
+      {children}
+    </Component>
+  );
+}
+
+export function MafCard({
+  children,
+  className,
+  ...rest
+}: {
+  children: ReactNode;
+  className?: string;
+} & HTMLAttributes<HTMLDivElement>) {
+  return (
+    <MafSurface className={className ?? ''} {...rest}>
+      {children}
+    </MafSurface>
+  );
+}
+

src/maf-ui/components/MafTabs.tsx

+'use client';
+
+import { ReactNode, useMemo, useState } from 'react';
+
+export type MafTabItem = {
+  key: string;
+  label: string;
+  panel: ReactNode;
+};
+
+export default function MafTabs({
+  items,
+  defaultActiveKey,
+}: {
+  items: MafTabItem[];
+  defaultActiveKey?: string;
+}) {
+  const initial = useMemo(() => {
+    if (defaultActiveKey && items.some((i) => i.key === defaultActiveKey)) return defaultActiveKey;
+    return items[0]?.key;
+  }, [defaultActiveKey, items]);
+
+  const [activeKey, setActiveKey] = useState<string | undefined>(initial);
+
+  return (
+    <div className="w-full">
+      <div className="flex gap-[4px] overflow-x-auto pb-1">
+        {items.map((it) => {
+          const active = it.key === activeKey;
+          return (
+            <button
+              key={it.key}
+              type="button"
+              className={[
+                'flex-shrink-0 px-4 py-2 rounded-[var(--r-sm)] border transition-colors text-xs font-semibold',
+                active ? 'bg-gold-pale border-gold-border-strong text-gold' : 'bg-surface-raised border-gold-border text-text-2 hover:text-text-1 hover:border-gold-border-strong',
+              ].join(' ')}
+              aria-pressed={active}
+              onClick={() => setActiveKey(it.key)}
+            >
+              {it.label}
+            </button>
+          );
+        })}
+      </div>
+      <div className="mt-4">{items.find((i) => i.key === activeKey)?.panel}</div>
+    </div>
+  );
+}
+

src/maf-ui/shell/MafAppShell.tsx

+// MAF-UIS app shell: fixed header, responsive sidebar/drawer, and mobile bottom nav.
+'use client';
+
+import { ReactNode, useMemo, useState } from 'react';
+import MafBottomNav, { MafBottomNavItem } from './MafBottomNav';
+import MafDrawer, { MafDrawerItem } from './MafDrawer';
+import MafHeader from './MafHeader';
+import MafNotificationCenter from './MafNotificationCenter';
+import MafSidebar, { MafNavItem } from './MafSidebar';
+import MafUserMenu, { MafUser } from './MafUserMenu';
+
+export type MafAppShellProps = {
+  children: ReactNode;
+  user: MafUser;
+  activeView?: string;
+  onNavigate?: (view: string) => void;
+};
+
+function Icon({ children }: { children: ReactNode }) {
+  return (
+    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
+      {children}
+    </svg>
+  );
+}
+
+export default function MafAppShell({ children, user, activeView = 'welcome', onNavigate }: MafAppShellProps) {
+  const [drawerOpen, setDrawerOpen] = useState(false);
+  const [notifOpen, setNotifOpen] = useState(false);
+  const [notifUnreadCount, setNotifUnreadCount] = useState(0);
+
+  const linkToView = (link: string) => {
+    // Map notification anchors used by MAF-UIS into our Next route "view" strings.
+    switch (link) {
+      case '#incidents':
+        return 'incidents';
+      case '#inspection':
+        return 'modules';
+      case '#admin':
+        return 'modules';
+      case '#profile':
+        return 'profile';
+      case '#settings':
+        return 'settings';
+      case '#notification-center':
+        return 'notification-center';
+      default:
+        return 'modules';
+    }
+  };
+
+  const navItems: MafNavItem[] = useMemo(
+    () => [
+      {
+        view: 'welcome',
+        label: 'Home',
+        icon: (
+          <Icon>
+            <path d="M3 9l9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z" />
+            <polyline points="9 22 9 12 15 12 15 22" />
+          </Icon>
+        ),
+      },
+      {
+        view: 'modules',
+        label: 'Modules',
+        icon: (
+          <Icon>
+            <rect x="3" y="3" width="7" height="7" rx="1" />
+            <rect x="14" y="3" width="7" height="7" rx="1" />
+            <rect x="14" y="14" width="7" height="7" rx="1" />
+            <rect x="3" y="14" width="7" height="7" rx="1" />
+          </Icon>
+        ),
+      },
+      {
+        view: 'incidents',
+        label: 'Incidents',
+        icon: (
+          <Icon>
+            <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z" />
+            <polyline points="14 2 14 8 20 8" />
+            <line x1="16" y1="13" x2="8" y2="13" />
+            <line x1="16" y1="17" x2="8" y2="17" />
+            <polyline points="10 9 9 9 8 9" />
+          </Icon>
+        ),
+      },
+      {
+        view: 'permit',
+        label: 'Permit',
+        icon: (
+          <Icon>
+            <rect x="3" y="4" width="18" height="18" rx="2" ry="2" />
+            <line x1="16" y1="2" x2="16" y2="6" />
+            <line x1="8" y1="2" x2="8" y2="6" />
+            <line x1="3" y1="10" x2="21" y2="10" />
+          </Icon>
+        ),
+      },
+      {
+        view: 'settings',
+        label: 'Settings',
+        icon: (
+          <Icon>
+            <circle cx="12" cy="12" r="3" />
+            <path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1 0 2.83 2 2 0 0 1-2.83 0l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-2 2 2 2 0 0 1-2-2v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83 0 2 2 0 0 1 0-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1-2-2 2 2 0 0 1 2-2h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 0-2.83 2 2 0 0 1 2.83 0l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 2-2 2 2 0 0 1 2 2v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 0 2 2 0 0 1 0 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 2 2 2 2 0 0 1-2 2h-.09a1.65 1.65 0 0 0-1.51 1z" />
+          </Icon>
+        ),
+      },
+    ],
+    []
+  );
+
+  const drawerItems: MafDrawerItem[] = useMemo(
+    () =>
+      navItems.map((x) => ({
+        view: x.view,
+        label: x.label,
+        icon: x.icon,
+      })),
+    [navItems]
+  );
+
+  const bottomItems: MafBottomNavItem[] = useMemo(
+    () => [
+      {
+        view: 'welcome',
+        label: 'Home',
+        icon: (
+          <Icon>
+            <path d="M3 9l9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z" />
+            <polyline points="9 22 9 12 15 12 15 22" />
+          </Icon>
+        ),
+      },
+      {
+        view: 'modules',
+        label: 'Modules',
+        icon: (
+          <Icon>
+            <rect x="3" y="3" width="7" height="7" rx="1" />
+            <rect x="14" y="3" width="7" height="7" rx="1" />
+            <rect x="14" y="14" width="7" height="7" rx="1" />
+            <rect x="3" y="14" width="7" height="7" rx="1" />
+          </Icon>
+        ),
+      },
+      {
+        view: 'incidents',
+        label: 'Incidents',
+        icon: (
+          <Icon>
+            <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z" />
+            <polyline points="14 2 14 8 20 8" />
+          </Icon>
+        ),
+      },
+      {
+        view: 'notification-center',
+        label: 'Alerts',
+        icon: (
+          <Icon>
+            <path d="M18 8A6 6 0 0 0 6 8c0 7-3 9-3 9h18s-3-2-3-9" />
+            <path d="M13.73 21a2 2 0 0 1-3.46 0" />
+          </Icon>
+        ),
+      },
+      {
+        view: 'profile',
+        label: 'Profile',
+        icon: (
+          <Icon>
+            <path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2" />
+            <circle cx="12" cy="7" r="4" />
+          </Icon>
+        ),
+      },
+    ],
+    []
+  );
+
+  return (
+    <div className="min-h-screen">
+      <MafSidebar items={navItems} activeView={activeView} onNavigate={onNavigate} />
+      <MafHeader
+        onOpenDrawer={() => setDrawerOpen(true)}
+        drawerOpen={drawerOpen}
+        user={user}
+        activeView={activeView}
+        onNavigate={onNavigate}
+        notifOpen={notifOpen}
+        notifUnreadCount={notifUnreadCount}
+        onToggleNotifications={() => setNotifOpen((v) => !v)}
+      />
+
+      <MafDrawer
+        open={drawerOpen}
+        items={drawerItems}
+        activeView={activeView}
+        onClose={() => setDrawerOpen(false)}
+        onNavigate={onNavigate}
+      />
+
+      <main
+        id="main-content"
+        tabIndex={-1}
+        className="relative flex-1 md:pl-[var(--sidebar-width)]"
+      >
+        {children}
+      </main>
+
+      <MafBottomNav items={bottomItems} activeView={activeView} onNavigate={onNavigate} />
+
+      <MafNotificationCenter
+        open={notifOpen}
+        onClose={() => setNotifOpen(false)}
+        unreadCount={notifUnreadCount}
+        onUnreadCountChange={setNotifUnreadCount}
+        onNavigate={(link) => {
+          const view = linkToView(link);
+          onNavigate?.(view);
+        }}
+        variant="dropdown"
+      />
+    </div>
+  );
+}
+

src/maf-ui/shell/MafBottomNav.tsx

+// Mobile bottom navigation.
+'use client';
+
+import { ReactNode } from 'react';
+
+export type MafBottomNavItem = {
+  view: string;
+  label: string;
+  icon?: ReactNode;
+};
+
+export default function MafBottomNav({
+  items,
+  activeView,
+  onNavigate,
+}: {
+  items: MafBottomNavItem[];
+  activeView?: string;
+  onNavigate?: (view: string) => void;
+}) {
+  return (
+    <nav
+      className="md:hidden fixed bottom-0 left-0 right-0 z-[998] h-[var(--bottom-nav-height)] bg-surface-raised border-t border-gold-border"
+      aria-label="Primary actions"
+    >
+      <div className="h-full flex items-stretch justify-around px-2">
+        {items.map((it) => {
+          const active = activeView && it.view === activeView;
+          return (
+            <a
+              key={it.view}
+              href="#"
+              className={[
+                'flex flex-col items-center justify-center flex-1 gap-1 rounded-[var(--r-sm)] transition-colors',
+                active ? 'text-maroon bg-gold-pale/40' : 'text-text-2 hover:text-text-1',
+              ].join(' ')}
+              aria-current={active ? 'page' : undefined}
+              onClick={(e) => {
+                e.preventDefault();
+                onNavigate?.(it.view);
+              }}
+            >
+              <div className="w-6 h-6 text-gold">{it.icon}</div>
+              <span className="text-[11px] font-semibold">{it.label}</span>
+            </a>
+          );
+        })}
+      </div>
+    </nav>
+  );
+}
+

src/maf-ui/shell/MafDrawer.tsx

+// Mobile right drawer navigation.
+'use client';
+
+import { ReactNode, useEffect, useRef } from 'react';
+
+export type MafDrawerItem = {
+  view: string;
+  label: string;
+  icon?: ReactNode;
+};
+
+export default function MafDrawer({
+  open,
+  items,
+  onClose,
+  activeView,
+  onNavigate,
+}: {
+  open: boolean;
+  items: MafDrawerItem[];
+  onClose: () => void;
+  activeView?: string;
+  onNavigate?: (view: string) => void;
+}) {
+  const closeBtnRef = useRef<HTMLButtonElement | null>(null);
+
+  useEffect(() => {
+    if (!open) return;
+    // Move focus to the close control for keyboard users.
+    closeBtnRef.current?.focus();
+  }, [open]);
+
+  useEffect(() => {
+    if (!open) return;
+    const onKeyDown = (e: KeyboardEvent) => {
+      if (e.key === 'Escape') onClose();
+    };
+    document.addEventListener('keydown', onKeyDown);
+    return () => document.removeEventListener('keydown', onKeyDown);
+  }, [open, onClose]);
+
+  return (
+    <>
+      <div
+        className={[
+          'fixed inset-0 z-[1000] bg-black/0 transition-opacity',
+          open ? 'opacity-100 pointer-events-auto' : 'opacity-0 pointer-events-none',
+        ].join(' ')}
+        id="mafDrawerBackdrop"
+        aria-hidden="true"
+        onClick={onClose}
+      />
+
+      <aside
+        id="mafDrawer"
+        className={[
+          'fixed top-0 right-0 bottom-0 z-[1001] border-l border-gold-border bg-surface-raised transition-transform',
+          open ? 'translate-x-0' : 'translate-x-full',
+          'w-[min(320px,90vw)]',
+        ].join(' ')}
+        role="dialog"
+        aria-modal="true"
+        aria-label="Navigation menu"
+        aria-hidden={!open}
+      >
+        <div className="flex items-center justify-between px-4 py-3 border-b border-gold-border">
+          <span className="text-text-3 text-xs uppercase tracking-[0.12em] font-semibold">Navigation</span>
+          <button
+            type="button"
+            ref={closeBtnRef}
+            className="w-10 h-10 flex items-center justify-center rounded-[var(--r-sm)] hover:bg-white/5 transition-colors text-text-2"
+            aria-label="Close menu"
+            onClick={onClose}
+          >
+            ×
+          </button>
+        </div>
+
+        <nav className="px-3 py-3 flex flex-col gap-1" aria-label="Mobile navigation">
+          {items.map((it) => {
+            const active = activeView && it.view === activeView;
+            return (
+              <a
+                key={it.view}
+                href="#"
+                className={[
+                  'drawer-item flex items-center gap-3 px-3 py-2 rounded-[var(--r-sm)] text-sm font-semibold transition-colors',
+                  active ? 'bg-gold-pale text-maroon' : 'text-text-2 hover:bg-white/5 hover:text-text-1',
+                ].join(' ')}
+                aria-current={active ? 'page' : undefined}
+                onClick={(e) => {
+                  e.preventDefault();
+                  onNavigate?.(it.view);
+                  onClose();
+                }}
+              >
+                <span className="w-9 h-9 rounded-[var(--r-sm)] border border-gold-border bg-white/0 flex items-center justify-center text-gold">
+                  {it.icon}
+                </span>
+                {it.label}
+              </a>
+            );
+          })}
+        </nav>
+
+        <div className="px-3 pb-4 pt-2 border-t border-gold-border mt-auto">
+          <a
+            href="#"
+            className="w-full flex items-center justify-center min-h-12 rounded-[var(--r-sm)] border border-gold-border bg-white/0 text-gold hover:bg-white/5 font-semibold text-sm"
+            onClick={(e) => {
+              e.preventDefault();
+              onClose();
+            }}
+          >
+            Support Center
+          </a>
+          <a
+            href="#"
+            className="w-full flex items-center justify-center min-h-12 rounded-[var(--r-sm)] mt-2 bg-gradient-to-r from-maroon to-maroon-bright text-white font-semibold text-sm hover:opacity-95"
+            onClick={(e) => {
+              e.preventDefault();
+              onClose();
+            }}
+          >
+            Login to Gateway
+          </a>
+        </div>
+      </aside>
+    </>
+  );
+}
+

src/maf-ui/shell/MafHeader.tsx

+// Fixed header (logo, search, actions).
+'use client';
+
+import MafThemeToggle from './MafThemeToggle';
+import MafUserMenu, { MafUser } from './MafUserMenu';
+
+import { ReactNode } from 'react';
+
+function IconWrap({ children }: { children: ReactNode }) {
+  return (
+    <button
+      type="button"
+      className="w-[44px] h-[44px] rounded-[var(--r-sm)] flex items-center justify-center text-text-2 hover:bg-gold-pale hover:text-gold transition-colors"
+    >
+      {children}
+    </button>
+  );
+}
+
+export default function MafHeader({
+  onOpenDrawer,
+  drawerOpen,
+  user,
+  activeView,
+  onNavigate,
+  notifOpen,
+  notifUnreadCount,
+  onToggleNotifications,
+}: {
+  onOpenDrawer: () => void;
+  drawerOpen: boolean;
+  user: MafUser;
+  activeView?: string;
+  onNavigate?: (view: string) => void;
+  notifOpen?: boolean;
+  notifUnreadCount?: number;
+  onToggleNotifications?: () => void;
+}) {
+  return (
+    <header
+      className="fixed top-0 left-0 right-0 md:left-[var(--sidebar-width)] z-[1000] h-[var(--header-height)] bg-surface-overlay/90 backdrop-blur-[20px] border-b border-gold-border flex items-center justify-between gap-3 px-3"
+      style={{
+        paddingTop: `max(0.35rem, env(safe-area-inset-top))`,
+        paddingBottom: `max(0.35rem, env(safe-area-inset-bottom))`,
+        paddingLeft: `max(0.75rem, env(safe-area-inset-left))`,
+        paddingRight: `max(0.75rem, env(safe-area-inset-right))`,
+      }}
+    >
+      <div className="flex items-center gap-3 min-w-0">
+        <button
+          type="button"
+          className="md:hidden w-[44px] h-[44px] min-w-[44px] min-h-[44px] rounded-[var(--r-sm)] bg-[var(--white)] border border-gold-border flex items-center justify-center text-text-1"
+          aria-label="Open menu"
+          aria-expanded={drawerOpen}
+          aria-controls="mafDrawer"
+          aria-haspopup="dialog"
+          onClick={onOpenDrawer}
+        >
+          <svg viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" strokeWidth="2">
+            <line x1="3" y1="6" x2="21" y2="6" />
+            <line x1="3" y1="12" x2="21" y2="12" />
+            <line x1="3" y1="18" x2="21" y2="18" />
+          </svg>
+        </button>
+
+        <a
+          href="#"
+          className="flex items-center gap-2 text-text-1 no-underline"
+          onClick={(e) => {
+            e.preventDefault();
+            onNavigate?.('welcome');
+          }}
+        >
+          <div
+            className="w-9 h-9 rounded-[var(--r-sm)] bg-gradient-to-br from-maroon to-maroon-bright flex items-center justify-center shadow-[var(--shadow-maroon)] relative overflow-hidden"
+            aria-hidden="true"
+          >
+            <span
+              className="text-white font-bold text-sm"
+              style={{ fontFamily: 'var(--font-display)' }}
+            >
+              M
+            </span>
+          </div>
+          <span className="hidden sm:block text-sm font-bold tracking-wide text-text-1">MAF Gateway</span>
+        </a>
+      </div>
+
+      <div className="flex-1 hidden lg:flex items-center justify-center px-6 min-w-0">
+        <div className="flex items-center gap-2 w-full max-w-[520px] bg-[var(--ink-3)]/60 border border-gold-border rounded-[var(--r-sm)] px-3 h-[44px]">
+          <svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" strokeWidth="2" aria-hidden="true">
+            <circle cx="11" cy="11" r="8" />
+            <line x1="21" y1="21" x2="16.65" y2="16.65" />
+          </svg>
+          <input
+            type="search"
+            placeholder="Search modules…"
+            className="w-full bg-transparent outline-none text-text-1 placeholder:text-text-3 text-sm"
+            aria-label="Search modules and pages"
+          />
+        </div>
+      </div>
+
+      <div className="flex items-center gap-2 min-w-0">
+        <MafThemeToggle />
+        <button
+          type="button"
+          className="icon-btn notif-trigger-wrap"
+          id="notifTrigger"
+          aria-label="Notifications"
+          aria-expanded={notifOpen ?? false}
+          aria-haspopup="true"
+          title="Notifications"
+          onClick={() => onToggleNotifications?.()}
+        >
+          <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" aria-hidden="true">
+            <path d="M18 8A6 6 0 0 0 6 8c0 7-3 9-3 9h18s-3-2-3-9" />
+            <path d="M13.73 21a2 2 0 0 1-3.46 0" />
+          </svg>
+          <span className="badge" id="notifBadge" style={{ display: (notifUnreadCount ?? 0) ? '' : 'none' }}>
+            {(notifUnreadCount ?? 0) > 99 ? '99+' : notifUnreadCount ?? 0}
+          </span>
+        </button>
+
+        <MafUserMenu
+          user={user}
+          onProfile={() => onNavigate?.('profile')}
+          onSettings={() => onNavigate?.('settings')}
+          onSignOut={() => {
+            // Placeholder for sign out flow.
+          }}
+        />
+      </div>
+    </header>
+  );
+}
+

src/maf-ui/shell/MafSidebar.tsx

+// Desktop sidebar navigation.
+'use client';
+
+import { ReactNode } from 'react';
+
+export type MafNavItem = {
+  view: string;
+  label: string;
+  icon?: ReactNode;
+};
+
+export default function MafSidebar({
+  items,
+  activeView,
+  onNavigate,
+}: {
+  items: MafNavItem[];
+  activeView?: string;
+  onNavigate?: (view: string) => void;
+}) {
+  return (
+    <nav
+      className="hidden md:flex fixed top-0 left-0 bottom-0 z-[999] w-[var(--sidebar-width)] bg-surface-raised border-r border-gold-border pt-[var(--header-height)] overflow-y-auto"
+      aria-label="Main navigation"
+    >
+      <div className="w-full px-3 pb-3">
+        <div className="h-[var(--header-height)] flex items-center">
+          <div className="text-text-3 text-xs uppercase tracking-[0.08em] font-semibold px-2">
+            Navigation
+          </div>
+        </div>
+
+        <div className="flex flex-col gap-1">
+          {items.map((it) => {
+            const active = activeView && it.view === activeView;
+            return (
+              <a
+                key={it.view}
+                href="#"
+                className={[
+                  'flex items-center gap-3 px-3 py-2 rounded-[var(--r-sm)] text-sm font-semibold transition-colors',
+                  active ? 'bg-gold-pale text-maroon' : 'text-text-2 hover:bg-white/5 hover:text-text-1',
+                ].join(' ')}
+                aria-current={active ? 'page' : undefined}
+                onClick={(e) => {
+                  e.preventDefault();
+                  onNavigate?.(it.view);
+                }}
+              >
+                <span className="w-9 h-9 rounded-[var(--r-sm)] border border-gold-border bg-white/0 flex items-center justify-center text-gold">
+                  {it.icon}
+                </span>
+                <span className="whitespace-nowrap">{it.label}</span>
+              </a>
+            );
+          })}
+        </div>
+      </div>
+    </nav>
+  );
+}
+

src/maf-ui/shell/MafThemeToggle.tsx

+// MAF theme toggle (dark-first) with persistence via localStorage.
+// This component is client-only because it touches `window`/`document`.
+'use client';
+
+import { useEffect, useMemo, useState } from 'react';
+
+type MafTheme = 'light' | 'dark';
+
+const STORAGE_KEY = 'maf_theme';
+
+function getStoredTheme(): MafTheme {
+  try {
+    const v = localStorage.getItem(STORAGE_KEY);
+    return v === 'light' ? 'light' : 'dark';
+  } catch {
+    return 'dark';
+  }
+}
+
+export default function MafThemeToggle() {
+  const [theme, setTheme] = useState<MafTheme>(() => {
+    if (typeof window === 'undefined') return 'dark';
+    const v = localStorage.getItem(STORAGE_KEY);
+    return v === 'light' ? 'light' : 'dark';
+  });
+
+  useEffect(() => {
+    // Keep html[data-theme] in sync with persisted theme.
+    document.documentElement.setAttribute('data-theme', theme === 'light' ? 'light' : 'dark');
+  }, []);
+
+  const nextTheme: MafTheme = useMemo(() => (theme === 'light' ? 'dark' : 'light'), [theme]);
+
+  return (
+    <button
+      type="button"
+      id="themeToggle"
+      className="theme-toggle"
+      aria-label={theme === 'light' ? 'Switch to dark theme' : 'Switch to light theme'}
+      title={theme === 'light' ? 'Dark mode' : 'Light mode'}
+      aria-pressed={theme === 'light'}
+      onClick={() => {
+        const t = nextTheme;
+        setTheme(t);
+        try {
+          localStorage.setItem(STORAGE_KEY, t);
+        } catch {
+          // ignore
+        }
+        document.documentElement.setAttribute('data-theme', t);
+      }}
+    >
+      <span className="icon-dark" aria-hidden="true">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+          <path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z" />
+        </svg>
+      </span>
+      <span className="icon-light" aria-hidden="true">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+          <circle cx="12" cy="12" r="5" />
+          <line x1="12" y1="1" x2="12" y2="3" />
+          <line x1="12" y1="21" x2="12" y2="23" />
+          <line x1="4.22" y1="4.22" x2="5.64" y2="5.64" />
+          <line x1="18.36" y1="18.36" x2="19.78" y2="19.78" />
+          <line x1="1" y1="12" x2="3" y2="12" />
+          <line x1="21" y1="12" x2="23" y2="12" />
+          <line x1="4.22" y1="19.78" x2="5.64" y2="18.36" />
+          <line x1="18.36" y1="5.64" x2="19.78" y2="4.22" />
+        </svg>
+      </span>
+    </button>
+  );
+}
+

src/maf-ui/shell/MafUserMenu.tsx

+// User dropdown menu anchored in the header.
+'use client';
+
+import { useEffect, useId, useMemo, useRef, useState } from 'react';
+
+export type MafUser = {
+  initials: string;
+  name: string;
+  role: string;
+};
+
+export type MafUserMenuProps = {
+  user: MafUser;
+  onProfile?: () => void;
+  onSettings?: () => void;
+  onSignOut?: () => void;
+};
+
+export default function MafUserMenu({ user, onProfile, onSettings, onSignOut }: MafUserMenuProps) {
+  const [open, setOpen] = useState(false);
+  const id = useId();
+  const triggerRef = useRef<HTMLButtonElement | null>(null);
+  const wrapRef = useRef<HTMLDivElement | null>(null);
+
+  const menuId = useMemo(() => `userMenu-${id.replace(/:/g, '')}`, [id]);
+
+  useEffect(() => {
+    if (!open) return;
+
+    const onKeyDown = (e: KeyboardEvent) => {
+      if (e.key === 'Escape') {
+        setOpen(false);
+        triggerRef.current?.focus();
+      }
+    };
+
+    const onPointerDown = (e: PointerEvent) => {
+      const el = e.target as Node | null;
+      if (!el) return;
+      if (!wrapRef.current) return;
+      if (!wrapRef.current.contains(el)) {
+        setOpen(false);
+      }
+    };
+
+    document.addEventListener('keydown', onKeyDown);
+    document.addEventListener('pointerdown', onPointerDown);
+    return () => {
+      document.removeEventListener('keydown', onKeyDown);
+      document.removeEventListener('pointerdown', onPointerDown);
+    };
+  }, [open]);
+
+  return (
+    <div ref={wrapRef} className="relative">
+      <button
+        ref={triggerRef}
+        type="button"
+        className="flex items-center gap-2 px-2.5 min-h-[44px] rounded-full border border-gold-border bg-white/0 hover:bg-white/5 transition-colors"
+        aria-label="User menu"
+        aria-haspopup="menu"
+        aria-expanded={open}
+        aria-controls={menuId}
+        onClick={() => setOpen((v) => !v)}
+      >
+        <div className="w-8 h-8 rounded-full bg-gradient-to-br from-maroon to-maroon-bright flex items-center justify-center text-white text-xs font-bold">
+          {user.initials}
+        </div>
+        <div className="text-left hidden sm:block">
+          <span className="block text-text-2 text-sm font-semibold leading-4">{user.name}</span>
+          <span className="block text-text-3 text-[11px] uppercase tracking-[0.08em] font-medium leading-3">
+            {user.role}
+          </span>
+        </div>
+      </button>
+
+      {open && (
+        <>
+          <div
+            className="fixed inset-0 z-[1000]"
+            aria-hidden="true"
+          />
+          <div
+            id={menuId}
+            role="menu"
+            aria-label="User menu"
+            className="absolute right-0 mt-2 z-[1001] min-w-[220px] rounded-[var(--r-md)] border border-gold-border bg-surface-raised shadow-[var(--shadow-deep)] py-2"
+          >
+            <button
+              type="button"
+              role="menuitem"
+              className="w-full flex items-center gap-3 px-4 py-2 text-text-2 hover:bg-white/5 hover:text-text-1 transition-colors text-sm"
+              onClick={() => {
+                setOpen(false);
+                onProfile?.();
+              }}
+            >
+              <svg viewBox="0 0 24 24" className="w-4 h-4" aria-hidden="true">
+                <path
+                  d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2"
+                  fill="none"
+                  stroke="currentColor"
+                  strokeWidth="2"
+                  strokeLinecap="round"
+                  strokeLinejoin="round"
+                />
+                <circle cx="12" cy="7" r="4" fill="none" stroke="currentColor" strokeWidth="2" />
+              </svg>
+              Profile
+            </button>
+
+            <button
+              type="button"
+              role="menuitem"
+              className="w-full flex items-center gap-3 px-4 py-2 text-text-2 hover:bg-white/5 hover:text-text-1 transition-colors text-sm"
+              onClick={() => {
+                setOpen(false);
+                onSettings?.();
+              }}
+            >
+              <svg viewBox="0 0 24 24" className="w-4 h-4" aria-hidden="true">
+                <circle cx="12" cy="12" r="3" fill="none" stroke="currentColor" strokeWidth="2" />
+                <path
+                  d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1 0 2.83 2 2 0 0 1-2.83 0l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-2 2 2 2 0 0 1-2-2v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83 0 2 2 0 0 1 0-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1-2-2 2 2 0 0 1 2-2h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 0-2.83 2 2 0 0 1 2.83 0l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 2-2 2 2 0 0 1 2 2v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 0 2 2 0 0 1 0 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 2 2 2 2 0 0 1-2 2h-.09a1.65 1.65 0 0 0-1.51 1z"
+                  fill="none"
+                  stroke="currentColor"
+                  strokeWidth="2"
+                />
+              </svg>
+              Settings
+            </button>
+
+            <div className="h-px bg-gold-border my-1" role="separator" />
+
+            <button
+              type="button"
+              role="menuitem"
+              className="w-full flex items-center gap-3 px-4 py-2 text-text-3 hover:bg-white/5 hover:text-red-400 transition-colors text-sm"
+              onClick={() => {
+                setOpen(false);
+                onSignOut?.();
+              }}
+            >
+              <svg viewBox="0 0 24 24" className="w-4 h-4" aria-hidden="true">
+                <path
+                  d="M9 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h4"
+                  fill="none"
+                  stroke="currentColor"
+                  strokeWidth="2"
+                  strokeLinecap="round"
+                  strokeLinejoin="round"
+                />
+                <polyline
+                  points="16 17 21 12 16 7"
+                  fill="none"
+                  stroke="currentColor"
+                  strokeWidth="2"
+                  strokeLinecap="round"
+                  strokeLinejoin="round"
+                />
+                <line x1="21" y1="12" x2="9" y2="12" fill="none" stroke="currentColor" strokeWidth="2" />
+              </svg>
+              Sign out
+            </button>
+          </div>
+        </>
+      )}
+    </div>
+  );
+}
+

stories/Badge.stories.tsx

+import type { Meta, StoryObj } from '@storybook/nextjs';
+
+import MafBadge from '@/src/maf-ui/components/MafBadge';
+
+const meta = {
+  title: 'MAF/Badge',
+  component: MafBadge,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'centered',
+  },
+  args: {
+    children: 'Badge',
+  },
+} satisfies Meta<typeof MafBadge>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Info: Story = { args: { tone: 'info', children: 'Info' } };
+export const Success: Story = { args: { tone: 'success', children: 'Success' } };
+export const Warning: Story = { args: { tone: 'warning', children: 'Warning' } };
+export const Action: Story = { args: { tone: 'action', children: 'Action' } };
+export const Draft: Story = { args: { tone: 'draft', children: 'Draft' } };
+

stories/BottomNav.stories.tsx

+import type { Meta, StoryObj } from '@storybook/nextjs';
+
+import MafBottomNav, { MafBottomNavItem } from '@/src/maf-ui/shell/MafBottomNav';
+
+const meta = {
+  title: 'MAF/Shell/BottomNav',
+  component: MafBottomNav,
+  tags: ['autodocs'],
+  parameters: { layout: 'fullscreen' },
+} satisfies Meta<typeof MafBottomNav>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+const icon = (
+  <svg viewBox="0 0 24 24" width="22" height="22" fill="none" stroke="currentColor" strokeWidth="2" aria-hidden="true">
+    <path d="M12 5v14M5 12h14" />
+  </svg>
+);
+
+const items: MafBottomNavItem[] = [
+  { view: 'welcome', label: 'Home', icon },
+  { view: 'modules', label: 'Modules', icon },
+  { view: 'incidents', label: 'Incidents', icon },
+  { view: 'notification-center', label: 'Alerts', icon },
+  { view: 'profile', label: 'Profile', icon },
+];
+
+export const ActiveIncidents: Story = {
+  args: {
+    items,
+    activeView: 'incidents',
+    onNavigate: () => {},
+  },
+};
+

stories/Button.stories.tsx

+import type { Meta, StoryObj } from '@storybook/nextjs';
+
+import { fn } from 'storybook/test';
+
+import { createElement } from 'react';
+
+import MafButton from '@/src/maf-ui/components/MafButton';
+
+const meta = {
+  title: 'MAF/Button',
+  component: MafButton,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'centered',
+  },
+  args: {
+    onClick: fn(),
+    children: 'Button',
+    disabled: false,
+  },
+} satisfies Meta<typeof MafButton>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Primary: Story = { args: { variant: 'primary', children: 'Primary' } };
+
+export const Secondary: Story = { args: { variant: 'secondary', children: 'Secondary' } };
+
+export const Ghost: Story = { args: { variant: 'ghost', children: 'Ghost' } };
+
+export const Sizes: Story = {
+  render: (args) =>
+    createElement(
+      'div',
+      { className: 'flex flex-col gap-3 items-center' },
+      createElement(MafButton, { ...args, size: 'small', variant: 'primary' }, 'Small'),
+      createElement(MafButton, { ...args, size: 'medium', variant: 'primary' }, 'Medium'),
+      createElement(MafButton, { ...args, size: 'large', variant: 'primary' }, 'Large')
+    ),
+  args: { onClick: fn() },
+};
+

stories/Button.tsx

+import './button.css';
+
+export interface ButtonProps {
+  /** Is this the principal call to action on the page? */
+  primary?: boolean;
+  /** What background color to use */
+  backgroundColor?: string;
+  /** How large should the button be? */
+  size?: 'small' | 'medium' | 'large';
+  /** Button contents */
+  label: string;
+  /** Optional click handler */
+  onClick?: () => void;
+}
+
+/** Primary UI component for user interaction */
+export const Button = ({
+  primary = false,
+  size = 'medium',
+  backgroundColor,
+  label,
+  ...props
+}: ButtonProps) => {
+  const mode = primary ? 'storybook-button--primary' : 'storybook-button--secondary';
+  return (
+    <button
+      type="button"
+      className={['storybook-button', `storybook-button--${size}`, mode].join(' ')}
+      {...props}
+    >
+      {label}
+      <style jsx>{`
+        button {
+          background-color: ${backgroundColor};
+        }
+      `}</style>
+    </button>
+  );
+};

stories/Card.stories.tsx

+import type { Meta, StoryObj } from '@storybook/nextjs';
+
+import { MafCard } from '@/src/maf-ui/components/MafCard';
+
+const meta = {
+  title: 'MAF/Card',
+  component: MafCard,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'centered',
+  },
+} satisfies Meta<typeof MafCard>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  args: {
+    children: 'Card',
+  },
+  render: () => (
+    <MafCard className="p-6 md:p-8">
+      <div className="font-semibold text-text-1">Card</div>
+      <div className="mt-2 text-text-2 text-sm leading-[var(--leading-relaxed)]">
+        Default surface styling for content containers.
+      </div>
+    </MafCard>
+  ),
+};
+
+export const WithBorderOverride: Story = {
+  args: {
+    children: 'Custom border',
+  },
+  render: () => (
+    <MafCard className="p-6 md:p-8 border-gold-border-strong">
+      <div className="font-semibold text-text-1">Custom border</div>
+      <div className="mt-2 text-text-2 text-sm">Useful for emphasis states.</div>
+    </MafCard>
+  ),
+};
+

stories/Drawer.stories.tsx

+import type { Meta, StoryObj } from '@storybook/nextjs';
+import { useState } from 'react';
+
+import MafDrawer, { MafDrawerItem } from '@/src/maf-ui/shell/MafDrawer';
+
+const meta = {
+  title: 'MAF/Shell/Drawer',
+  component: MafDrawer,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'fullscreen',
+  },
+} satisfies Meta<typeof MafDrawer>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+const icon = (
+  <svg viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" strokeWidth="2" aria-hidden="true">
+    <path d="M4 6h16M4 12h16M4 18h16" />
+  </svg>
+);
+
+const items: MafDrawerItem[] = [
+  { view: 'welcome', label: 'Home', icon },
+  { view: 'modules', label: 'Modules', icon },
+  { view: 'incidents', label: 'Incidents', icon },
+];
+
+export const Open: Story = {
+  args: {
+    open: true,
+    items,
+    activeView: 'modules',
+    onClose: () => {},
+    onNavigate: () => {},
+  },
+  render: () => {
+    const [open, setOpen] = useState(true);
+    return <MafDrawer open={open} items={items} activeView="modules" onClose={() => setOpen(false)} onNavigate={() => {}} />;
+  },
+};
+
+export const Closed: Story = {
+  args: {
+    open: false,
+    items,
+    activeView: 'modules',
+    onClose: () => {},
+    onNavigate: () => {},
+  },
+  render: () => <MafDrawer open={false} items={items} activeView="modules" onClose={() => {}} onNavigate={() => {}} />,
+};
+

stories/Header.stories.tsx

+import type { Meta, StoryObj } from '@storybook/nextjs';
+
+import MafTabs from '@/src/maf-ui/components/MafTabs';
+import { MafCard } from '@/src/maf-ui/components/MafCard';
+
+const meta = {
+  title: 'MAF/Tabs (Legacy)',
+  component: MafTabs,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'centered',
+  },
+} satisfies Meta<typeof MafTabs>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  args: {
+    items: [],
+    defaultActiveKey: 'overview',
+  },
+  render: () => (
+    <div className="w-full max-w-[720px] p-6">
+      <MafCard className="p-4 md:p-6">
+        <MafTabs
+          defaultActiveKey="overview"
+          items={[
+            {
+              key: 'overview',
+              label: 'Overview',
+              panel: <div className="text-text-2 text-sm">Overview content goes here.</div>,
+            },
+            {
+              key: 'activity',
+              label: 'Activity',
+              panel: <div className="text-text-2 text-sm">Activity content goes here.</div>,
+            },
+            {
+              key: 'settings',
+              label: 'Settings',
+              panel: <div className="text-text-2 text-sm">Settings content goes here.</div>,
+            },
+          ]}
+        />
+      </MafCard>
+    </div>
+  ),
+};
+

stories/Header.tsx

+import { Button } from './Button';
+import './header.css';
+
+type User = {
+  name: string;
+};
+
+export interface HeaderProps {
+  user?: User;
+  onLogin?: () => void;
+  onLogout?: () => void;
+  onCreateAccount?: () => void;
+}
+
+export const Header = ({ user, onLogin, onLogout, onCreateAccount }: HeaderProps) => (
+  <header>
+    <div className="storybook-header">
+      <div>
+        <svg width="32" height="32" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
+          <g fill="none" fillRule="evenodd">
+            <path
+              d="M10 0h12a10 10 0 0110 10v12a10 10 0 01-10 10H10A10 10 0 010 22V10A10 10 0 0110 0z"
+              fill="#FFF"
+            />
+            <path
+              d="M5.3 10.6l10.4 6v11.1l-10.4-6v-11zm11.4-6.2l9.7 5.5-9.7 5.6V4.4z"
+              fill="#555AB9"
+            />
+            <path
+              d="M27.2 10.6v11.2l-10.5 6V16.5l10.5-6zM15.7 4.4v11L6 10l9.7-5.5z"
+              fill="#91BAF8"
+            />
+          </g>
+        </svg>
+        <h1>Acme</h1>
+      </div>
+      <div>
+        {user ? (
+          <>
+            <span className="welcome">
+              Welcome, <b>{user.name}</b>!
+            </span>
+            <Button size="small" onClick={onLogout} label="Log out" />
+          </>
+        ) : (
+          <>
+            <Button size="small" onClick={onLogin} label="Log in" />
+            <Button primary size="small" onClick={onCreateAccount} label="Sign up" />
+          </>
+        )}
+      </div>
+    </div>
+  </header>
+);

stories/LoginModal.stories.tsx

+import type { Meta, StoryObj } from '@storybook/nextjs';
+
+import MafLoginModal from '@/src/maf-ui/auth/MafLoginModal';
+import type { MafUser } from '@/src/maf-ui/shell/MafUserMenu';
+
+const meta = {
+  title: 'MAF/Auth/LoginModal',
+  component: MafLoginModal,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'fullscreen',
+  },
+} satisfies Meta<typeof MafLoginModal>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+const onSuccess = (u: MafUser) => {
+  // no-op for Storybook
+  void u;
+};
+
+export const EmployeeOpen: Story = {
+  args: {
+    open: true,
+    defaultAccountType: 'employee',
+    onClose: () => {},
+    onSuccess,
+  },
+  render: () => <MafLoginModal open defaultAccountType="employee" onClose={() => {}} onSuccess={onSuccess} />,
+};
+
+export const ContractorOpen: Story = {
+  args: {
+    open: true,
+    defaultAccountType: 'contractor',
+    onClose: () => {},
+    onSuccess,
+  },
+  render: () => <MafLoginModal open defaultAccountType="contractor" onClose={() => {}} onSuccess={onSuccess} />,
+};
+

stories/NotificationCenter.stories.tsx

+import type { Meta, StoryObj } from '@storybook/nextjs';
+
+import MafNotificationCenter from '@/src/maf-ui/shell/MafNotificationCenter';
+import { useEffect } from 'react';
+
+const meta = {
+  title: 'MAF/NotificationCenter',
+  component: MafNotificationCenter,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'fullscreen',
+  },
+} satisfies Meta<typeof MafNotificationCenter>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+function NotifSetup({ readIds }: { readIds: string[] }) {
+  useEffect(() => {
+    try {
+      sessionStorage.setItem('maf_notif_read', JSON.stringify(readIds));
+    } catch {
+      // ignore
+    }
+    // Ensure we're in a known theme.
+    document.documentElement.setAttribute('data-theme', 'dark');
+  }, [readIds]);
+
+  return null;
+}
+
+export const DropdownWithUnread: Story = {
+  args: {
+    open: true,
+    variant: 'dropdown',
+    unreadCount: 0,
+    onUnreadCountChange: () => {},
+    onClose: () => {},
+    onNavigate: () => {},
+  },
+  render: () => {
+    // Mark only one notification as read to demonstrate badge count.
+    const readIds = ['2', '5'];
+    return (
+      <>
+        <NotifSetup readIds={readIds} />
+        <div className="p-6">
+          <MafNotificationCenter
+            open
+            variant="dropdown"
+            unreadCount={0}
+            onUnreadCountChange={() => {}}
+            onClose={() => {}}
+            onNavigate={() => {}}
+          />
+        </div>
+      </>
+    );
+  },
+};
+
+export const PageVariant: Story = {
+  args: {
+    open: true,
+    variant: 'page',
+    unreadCount: 0,
+    onUnreadCountChange: () => {},
+    onClose: () => {},
+    onNavigate: () => {},
+  },
+  render: () => {
+    const readIds: string[] = [];
+    return (
+      <>
+        <NotifSetup readIds={readIds} />
+        <div className="p-6 max-w-[980px] mx-auto">
+          <MafNotificationCenter
+            open
+            variant="page"
+            unreadCount={0}
+            onUnreadCountChange={() => {}}
+            onClose={() => {}}
+            onNavigate={() => {}}
+          />
+        </div>
+      </>
+    );
+  },
+};
+

stories/Page.stories.tsx

+import type { Meta, StoryObj } from '@storybook/nextjs';
+
+import { useMemo, useState } from 'react';
+
+import MafAppShell from '@/src/maf-ui/shell/MafAppShell';
+
+const meta = {
+  title: 'MAF/AppShell',
+  component: MafAppShell,
+  parameters: {
+    layout: 'fullscreen',
+  },
+} satisfies Meta<typeof MafAppShell>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const ShellWelcome: Story = {
+  args: {
+    user: {
+      initials: 'NL',
+      name: 'Nino Lester Cruz',
+      role: 'Admin',
+    },
+    activeView: 'welcome',
+    children: null,
+  },
+  render: () => {
+    const user = useMemo(
+      () => ({
+        initials: 'NL',
+        name: 'Nino Lester Cruz',
+        role: 'Admin',
+      }),
+      []
+    );
+
+    const [view, setView] = useState<
+      'welcome' | 'modules' | 'incidents' | 'permit' | 'settings' | 'profile' | 'notification-center'
+    >('welcome');
+
+    return (
+      <MafAppShell user={user} activeView={view} onNavigate={(next) => setView(next as any)}>
+        <div className="w-full max-w-[980px] mx-auto px-3 md:px-6 py-6">
+          <section className="rounded-[var(--r-lg)] border border-gold-border bg-surface-raised p-6 md:p-8">
+            <h1
+              className="text-[var(--text-2xl)] leading-[var(--leading-tight)] tracking-[var(--tracking-tight)] font-semibold text-text-1 mb-3"
+              style={{ fontFamily: 'var(--font-display)' }}
+            >
+              Storybook shell validation
+            </h1>
+            <p className="text-text-2 text-sm leading-[var(--leading-relaxed)]">
+              Theme toggle, sidebar, drawer, and bottom nav should match the MAF-UIS layout.
+            </p>
+            <div className="mt-4 flex gap-3 flex-wrap">
+              <button
+                type="button"
+                className="rounded-[var(--r-sm)] border border-gold-border bg-white/0 hover:bg-white/5 px-4 py-2 text-text-1 font-semibold text-sm"
+                onClick={() => setView('welcome')}
+              >
+                Welcome
+              </button>
+              <button
+                type="button"
+                className="rounded-[var(--r-sm)] border border-gold-border bg-white/0 hover:bg-white/5 px-4 py-2 text-text-1 font-semibold text-sm"
+                onClick={() => setView('modules')}
+              >
+                Modules
+              </button>
+              <button
+                type="button"
+                className="rounded-[var(--r-sm)] border border-gold-border bg-white/0 hover:bg-white/5 px-4 py-2 text-text-1 font-semibold text-sm"
+                onClick={() => setView('incidents')}
+              >
+                Incidents
+              </button>
+            </div>
+          </section>
+        </div>
+      </MafAppShell>
+    );
+  },
+};
+

stories/Page.tsx

+import React from 'react';
+
+import { Header } from './Header';
+import './page.css';
+
+type User = {
+  name: string;
+};
+
+export const Page: React.FC = () => {
+  const [user, setUser] = React.useState<User>();
+
+  return (
+    <article>
+      <Header
+        user={user}
+        onLogin={() => setUser({ name: 'Jane Doe' })}
+        onLogout={() => setUser(undefined)}
+        onCreateAccount={() => setUser({ name: 'Jane Doe' })}
+      />
+
+      <section className="storybook-page">
+        <h2>Pages in Storybook</h2>
+        <p>
+          We recommend building UIs with a{' '}
+          <a href="https://componentdriven.org" target="_blank" rel="noopener noreferrer">
+            <strong>component-driven</strong>
+          </a>{' '}
+          process starting with atomic components and ending with pages.
+        </p>
+        <p>
+          Render pages with mock data. This makes it easy to build and review page states without
+          needing to navigate to them in your app. Here are some handy patterns for managing page
+          data in Storybook:
+        </p>
+        <ul>
+          <li>
+            Use a higher-level connected component. Storybook helps you compose such data from the
+            "args" of child component stories
+          </li>
+          <li>
+            Assemble data in the page component from your services. You can mock these services out
+            using Storybook.
+          </li>
+        </ul>
+        <p>
+          Get a guided tutorial on component-driven development at{' '}
+          <a href="https://storybook.js.org/tutorials/" target="_blank" rel="noopener noreferrer">
+            Storybook tutorials
+          </a>
+          . Read more in the{' '}
+          <a href="https://storybook.js.org/docs" target="_blank" rel="noopener noreferrer">
+            docs
+          </a>
+          .
+        </p>
+        <div className="tip-wrapper">
+          <span className="tip">Tip</span> Adjust the width of the canvas with the{' '}
+          <svg width="10" height="10" viewBox="0 0 12 12" xmlns="http://www.w3.org/2000/svg">
+            <g fill="none" fillRule="evenodd">
+              <path
+                d="M1.5 5.2h4.8c.3 0 .5.2.5.4v5.1c-.1.2-.3.3-.4.3H1.4a.5.5 0 01-.5-.4V5.7c0-.3.2-.5.5-.5zm0-2.1h6.9c.3 0 .5.2.5.4v7a.5.5 0 01-1 0V4H1.5a.5.5 0 010-1zm0-2.1h9c.3 0 .5.2.5.4v9.1a.5.5 0 01-1 0V2H1.5a.5.5 0 010-1zm4.3 5.2H2V10h3.8V6.2z"
+                id="a"
+                fill="#999"
+              />
+            </g>
+          </svg>
+          Viewports addon in the toolbar
+        </div>
+      </section>
+    </article>
+  );
+};

stories/Sidebar.stories.tsx

+import type { Meta, StoryObj } from '@storybook/nextjs';
+
+import MafSidebar, { MafNavItem } from '@/src/maf-ui/shell/MafSidebar';
+
+const meta = {
+  title: 'MAF/Shell/Sidebar',
+  component: MafSidebar,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'fullscreen',
+  },
+} satisfies Meta<typeof MafSidebar>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+const icon = (
+  <svg viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" strokeWidth="2" aria-hidden="true">
+    <path d="M12 6v6l4 2" />
+    <circle cx="12" cy="12" r="10" />
+  </svg>
+);
+
+const items: MafNavItem[] = [
+  { view: 'welcome', label: 'Home', icon },
+  { view: 'modules', label: 'Modules', icon },
+  { view: 'incidents', label: 'Incidents', icon },
+  { view: 'permit', label: 'Permit', icon },
+  { view: 'settings', label: 'Settings', icon },
+  { view: 'profile', label: 'Profile', icon },
+];
+
+export const ActiveModules: Story = {
+  args: {
+    items,
+    activeView: 'modules',
+    onNavigate: () => {},
+  },
+  render: () => <MafSidebar items={items} activeView="modules" onNavigate={() => {}} />,
+};
+

stories/Tabs.stories.tsx

+import type { Meta, StoryObj } from '@storybook/nextjs';
+
+import MafTabs from '@/src/maf-ui/components/MafTabs';
+import { MafCard } from '@/src/maf-ui/components/MafCard';
+
+const meta = {
+  title: 'MAF/Tabs',
+  component: MafTabs,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'centered',
+  },
+} satisfies Meta<typeof MafTabs>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  args: {
+    items: [],
+    defaultActiveKey: 'overview',
+  },
+  render: () => (
+    <div className="w-full max-w-[720px] p-6">
+      <MafCard className="p-4 md:p-6">
+        <MafTabs
+          defaultActiveKey="overview"
+          items={[
+            {
+              key: 'overview',
+              label: 'Overview',
+              panel: <div className="text-text-2 text-sm">Overview content.</div>,
+            },
+            {
+              key: 'activity',
+              label: 'Activity',
+              panel: <div className="text-text-2 text-sm">Activity content.</div>,
+            },
+            {
+              key: 'settings',
+              label: 'Settings',
+              panel: <div className="text-text-2 text-sm">Settings content.</div>,
+            },
+          ]}
+        />
+      </MafCard>
+    </div>
+  ),
+};
+

stories/ThemeToggle.stories.tsx

+import type { Meta, StoryObj } from '@storybook/nextjs';
+
+import { useEffect } from 'react';
+
+import MafThemeToggle from '@/src/maf-ui/shell/MafThemeToggle';
+
+const meta = {
+  title: 'MAF/ThemeToggle',
+  component: MafThemeToggle,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'centered',
+  },
+} satisfies Meta<typeof MafThemeToggle>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+function ThemeSetup({ theme }: { theme: 'light' | 'dark' }) {
+  useEffect(() => {
+    try {
+      localStorage.setItem('maf_theme', theme);
+    } catch {
+      // ignore
+    }
+    document.documentElement.setAttribute('data-theme', theme);
+  }, [theme]);
+
+  return <MafThemeToggle />;
+}
+
+export const Dark: Story = {
+  render: () => <ThemeSetup theme="dark" />,
+};
+
+export const Light: Story = {
+  render: () => <ThemeSetup theme="light" />,
+};
+

stories/assets/accessibility.svg

+<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" fill="none" viewBox="0 0 48 48"><title>Accessibility</title><circle cx="24.334" cy="24" r="24" fill="#A849FF" fill-opacity=".3"/><path fill="#A470D5" fill-rule="evenodd" d="M27.8609 11.585C27.8609 9.59506 26.2497 7.99023 24.2519 7.99023C22.254 7.99023 20.6429 9.65925 20.6429 11.585C20.6429 13.575 22.254 15.1799 24.2519 15.1799C26.2497 15.1799 27.8609 13.575 27.8609 11.585ZM21.8922 22.6473C21.8467 23.9096 21.7901 25.4788 21.5897 26.2771C20.9853 29.0462 17.7348 36.3314 17.3325 37.2275C17.1891 37.4923 17.1077 37.7955 17.1077 38.1178C17.1077 39.1519 17.946 39.9902 18.9802 39.9902C19.6587 39.9902 20.253 39.6293 20.5814 39.0889L20.6429 38.9874L24.2841 31.22C24.2841 31.22 27.5529 37.9214 27.9238 38.6591C28.2948 39.3967 28.8709 39.9902 29.7168 39.9902C30.751 39.9902 31.5893 39.1519 31.5893 38.1178C31.5893 37.7951 31.3639 37.2265 31.3639 37.2265C30.9581 36.3258 27.698 29.0452 27.0938 26.2771C26.8975 25.4948 26.847 23.9722 26.8056 22.7236C26.7927 22.333 26.7806 21.9693 26.7653 21.6634C26.7008 21.214 27.0231 20.8289 27.4097 20.7005L35.3366 18.3253C36.3033 18.0685 36.8834 16.9773 36.6256 16.0144C36.3678 15.0515 35.2722 14.4737 34.3055 14.7305C34.3055 14.7305 26.8619 17.1057 24.2841 17.1057C21.7062 17.1057 14.456 14.7947 14.456 14.7947C13.4893 14.5379 12.3937 14.9873 12.0715 15.9502C11.7493 16.9131 12.3293 18.0044 13.3604 18.3253L21.2873 20.7005C21.674 20.8289 21.9318 21.214 21.9318 21.6634C21.9174 21.9493 21.9053 22.2857 21.8922 22.6473Z" clip-rule="evenodd"/></svg>
\ No newline at end of file

stories/assets/discord.svg

+<svg xmlns="http://www.w3.org/2000/svg" width="33" height="32" fill="none" viewBox="0 0 33 32"><g clip-path="url(#clip0_10031_177575)"><mask id="mask0_10031_177575" style="mask-type:luminance" width="33" height="25" x="0" y="4" maskUnits="userSpaceOnUse"><path fill="#fff" d="M32.5034 4.00195H0.503906V28.7758H32.5034V4.00195Z"/></mask><g mask="url(#mask0_10031_177575)"><path fill="#5865F2" d="M27.5928 6.20817C25.5533 5.27289 23.3662 4.58382 21.0794 4.18916C21.0378 4.18154 20.9962 4.20057 20.9747 4.23864C20.6935 4.73863 20.3819 5.3909 20.1637 5.90358C17.7042 5.53558 15.2573 5.53558 12.8481 5.90358C12.6299 5.37951 12.307 4.73863 12.0245 4.23864C12.003 4.20184 11.9614 4.18281 11.9198 4.18916C9.63431 4.58255 7.44721 5.27163 5.40641 6.20817C5.38874 6.21578 5.3736 6.22848 5.36355 6.24497C1.21508 12.439 0.078646 18.4809 0.636144 24.4478C0.638667 24.477 0.655064 24.5049 0.677768 24.5227C3.41481 26.5315 6.06609 27.7511 8.66815 28.5594C8.70979 28.5721 8.75392 28.5569 8.78042 28.5226C9.39594 27.6826 9.94461 26.7968 10.4151 25.8653C10.4428 25.8107 10.4163 25.746 10.3596 25.7244C9.48927 25.3945 8.66058 24.9922 7.86343 24.5354C7.80038 24.4986 7.79533 24.4084 7.85333 24.3653C8.02108 24.2397 8.18888 24.109 8.34906 23.977C8.37804 23.9529 8.41842 23.9478 8.45249 23.963C13.6894 26.3526 19.359 26.3526 24.5341 23.963C24.5682 23.9465 24.6086 23.9516 24.6388 23.9757C24.799 24.1077 24.9668 24.2397 25.1358 24.3653C25.1938 24.4084 25.19 24.4986 25.127 24.5354C24.3298 25.0011 23.5011 25.3945 22.6296 25.7232C22.5728 25.7447 22.5476 25.8107 22.5754 25.8653C23.0559 26.7955 23.6046 27.6812 24.2087 28.5213C24.234 28.5569 24.2794 28.5721 24.321 28.5594C26.9357 27.7511 29.5869 26.5315 32.324 24.5227C32.348 24.5049 32.3631 24.4783 32.3656 24.4491C33.0328 17.5506 31.2481 11.5584 27.6344 6.24623C27.6256 6.22848 27.6105 6.21578 27.5928 6.20817ZM11.1971 20.8146C9.62043 20.8146 8.32129 19.3679 8.32129 17.5913C8.32129 15.8146 9.59523 14.368 11.1971 14.368C12.8115 14.368 14.0981 15.8273 14.0729 17.5913C14.0729 19.3679 12.7989 20.8146 11.1971 20.8146ZM21.8299 20.8146C20.2533 20.8146 18.9541 19.3679 18.9541 17.5913C18.9541 15.8146 20.228 14.368 21.8299 14.368C23.4444 14.368 24.7309 15.8273 24.7057 17.5913C24.7057 19.3679 23.4444 20.8146 21.8299 20.8146Z"/></g></g><defs><clipPath id="clip0_10031_177575"><rect width="32" height="32" fill="#fff" transform="translate(0.5)"/></clipPath></defs></svg>
\ No newline at end of file

stories/assets/github.svg

+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" fill="none" viewBox="0 0 32 32"><path fill="#161614" d="M16.0001 0C7.16466 0 0 7.17472 0 16.0256C0 23.1061 4.58452 29.1131 10.9419 31.2322C11.7415 31.3805 12.0351 30.8845 12.0351 30.4613C12.0351 30.0791 12.0202 28.8167 12.0133 27.4776C7.56209 28.447 6.62283 25.5868 6.62283 25.5868C5.89499 23.7345 4.8463 23.2419 4.8463 23.2419C3.39461 22.2473 4.95573 22.2678 4.95573 22.2678C6.56242 22.3808 7.40842 23.9192 7.40842 23.9192C8.83547 26.3691 11.1514 25.6609 12.0645 25.2514C12.2081 24.2156 12.6227 23.5087 13.0803 23.1085C9.52648 22.7032 5.7906 21.3291 5.7906 15.1886C5.7906 13.4389 6.41563 12.0094 7.43916 10.8871C7.27303 10.4834 6.72537 8.85349 7.59415 6.64609C7.59415 6.64609 8.93774 6.21539 11.9953 8.28877C13.2716 7.9337 14.6404 7.75563 16.0001 7.74953C17.3599 7.75563 18.7297 7.9337 20.0084 8.28877C23.0623 6.21539 24.404 6.64609 24.404 6.64609C25.2749 8.85349 24.727 10.4834 24.5608 10.8871C25.5868 12.0094 26.2075 13.4389 26.2075 15.1886C26.2075 21.3437 22.4645 22.699 18.9017 23.0957C19.4756 23.593 19.9869 24.5683 19.9869 26.0634C19.9869 28.2077 19.9684 29.9334 19.9684 30.4613C19.9684 30.8877 20.2564 31.3874 21.0674 31.2301C27.4213 29.1086 32 23.1037 32 16.0256C32 7.17472 24.8364 0 16.0001 0ZM5.99257 22.8288C5.95733 22.9084 5.83227 22.9322 5.71834 22.8776C5.60229 22.8253 5.53711 22.7168 5.57474 22.6369C5.60918 22.5549 5.7345 22.5321 5.85029 22.587C5.9666 22.6393 6.03284 22.7489 5.99257 22.8288ZM6.7796 23.5321C6.70329 23.603 6.55412 23.5701 6.45291 23.4581C6.34825 23.3464 6.32864 23.197 6.40601 23.125C6.4847 23.0542 6.62937 23.0874 6.73429 23.1991C6.83895 23.3121 6.85935 23.4605 6.7796 23.5321ZM7.31953 24.4321C7.2215 24.5003 7.0612 24.4363 6.96211 24.2938C6.86407 24.1513 6.86407 23.9804 6.96422 23.9119C7.06358 23.8435 7.2215 23.905 7.32191 24.0465C7.41968 24.1914 7.41968 24.3623 7.31953 24.4321ZM8.23267 25.4743C8.14497 25.5712 7.95818 25.5452 7.82146 25.413C7.68156 25.2838 7.64261 25.1004 7.73058 25.0035C7.81934 24.9064 8.00719 24.9337 8.14497 25.0648C8.28381 25.1938 8.3262 25.3785 8.23267 25.4743ZM9.41281 25.8262C9.37413 25.9517 9.19423 26.0088 9.013 25.9554C8.83203 25.9005 8.7136 25.7535 8.75016 25.6266C8.78778 25.5003 8.96848 25.4408 9.15104 25.4979C9.33174 25.5526 9.45044 25.6985 9.41281 25.8262ZM10.7559 25.9754C10.7604 26.1076 10.6067 26.2172 10.4165 26.2196C10.2252 26.2238 10.0704 26.1169 10.0683 25.9868C10.0683 25.8534 10.2185 25.7448 10.4098 25.7416C10.6001 25.7379 10.7559 25.8441 10.7559 25.9754ZM12.0753 25.9248C12.0981 26.0537 11.9658 26.1862 11.7769 26.2215C11.5912 26.2554 11.4192 26.1758 11.3957 26.0479C11.3726 25.9157 11.5072 25.7833 11.6927 25.7491C11.8819 25.7162 12.0512 25.7937 12.0753 25.9248Z"/></svg>
\ No newline at end of file

stories/assets/tutorials.svg

+<svg xmlns="http://www.w3.org/2000/svg" width="33" height="32" fill="none" viewBox="0 0 33 32"><g clip-path="url(#clip0_10031_177597)"><path fill="#B7F0EF" fill-rule="evenodd" d="M17 7.87059C17 6.48214 17.9812 5.28722 19.3431 5.01709L29.5249 2.99755C31.3238 2.64076 33 4.01717 33 5.85105V22.1344C33 23.5229 32.0188 24.7178 30.6569 24.9879L20.4751 27.0074C18.6762 27.3642 17 25.9878 17 24.1539L17 7.87059Z" clip-rule="evenodd" opacity=".7"/><path fill="#87E6E5" fill-rule="evenodd" d="M1 5.85245C1 4.01857 2.67623 2.64215 4.47507 2.99895L14.6569 5.01848C16.0188 5.28861 17 6.48354 17 7.87198V24.1553C17 25.9892 15.3238 27.3656 13.5249 27.0088L3.34311 24.9893C1.98119 24.7192 1 23.5242 1 22.1358V5.85245Z" clip-rule="evenodd"/><path fill="#61C1FD" fill-rule="evenodd" d="M15.543 5.71289C15.543 5.71289 16.8157 5.96289 17.4002 6.57653C17.9847 7.19016 18.4521 9.03107 18.4521 9.03107C18.4521 9.03107 18.4521 25.1106 18.4521 26.9629C18.4521 28.8152 19.3775 31.4174 19.3775 31.4174L17.4002 28.8947L16.2575 31.4174C16.2575 31.4174 15.543 29.0765 15.543 27.122C15.543 25.1674 15.543 5.71289 15.543 5.71289Z" clip-rule="evenodd"/></g><defs><clipPath id="clip0_10031_177597"><rect width="32" height="32" fill="#fff" transform="translate(0.5)"/></clipPath></defs></svg>
\ No newline at end of file

stories/assets/youtube.svg

+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" fill="none" viewBox="0 0 32 32"><path fill="#ED1D24" d="M31.3313 8.44657C30.9633 7.08998 29.8791 6.02172 28.5022 5.65916C26.0067 5.00026 16 5.00026 16 5.00026C16 5.00026 5.99333 5.00026 3.4978 5.65916C2.12102 6.02172 1.03665 7.08998 0.668678 8.44657C0 10.9053 0 16.0353 0 16.0353C0 16.0353 0 21.1652 0.668678 23.6242C1.03665 24.9806 2.12102 26.0489 3.4978 26.4116C5.99333 27.0703 16 27.0703 16 27.0703C16 27.0703 26.0067 27.0703 28.5022 26.4116C29.8791 26.0489 30.9633 24.9806 31.3313 23.6242C32 21.1652 32 16.0353 32 16.0353C32 16.0353 32 10.9053 31.3313 8.44657Z"/><path fill="#fff" d="M12.7266 20.6934L21.0902 16.036L12.7266 11.3781V20.6934Z"/></svg>
\ No newline at end of file

stories/button.css

+.storybook-button {
+  display: inline-block;
+  cursor: pointer;
+  border: 0;
+  border-radius: 3em;
+  font-weight: 700;
+  line-height: 1;
+  font-family: 'Nunito Sans', 'Helvetica Neue', Helvetica, Arial, sans-serif;
+}
+.storybook-button--primary {
+  background-color: #555ab9;
+  color: white;
+}
+.storybook-button--secondary {
+  box-shadow: rgba(0, 0, 0, 0.15) 0px 0px 0px 1px inset;
+  background-color: transparent;
+  color: #333;
+}
+.storybook-button--small {
+  padding: 10px 16px;
+  font-size: 12px;
+}
+.storybook-button--medium {
+  padding: 11px 20px;
+  font-size: 14px;
+}
+.storybook-button--large {
+  padding: 12px 24px;
+  font-size: 16px;
+}

stories/header.css

+.storybook-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  border-bottom: 1px solid rgba(0, 0, 0, 0.1);
+  padding: 15px 20px;
+  font-family: 'Nunito Sans', 'Helvetica Neue', Helvetica, Arial, sans-serif;
+}
+
+.storybook-header svg {
+  display: inline-block;
+  vertical-align: top;
+}
+
+.storybook-header h1 {
+  display: inline-block;
+  vertical-align: top;
+  margin: 6px 0 6px 10px;
+  font-weight: 700;
+  font-size: 20px;
+  line-height: 1;
+}
+
+.storybook-header button + button {
+  margin-left: 10px;
+}
+
+.storybook-header .welcome {
+  margin-right: 10px;
+  color: #333;
+  font-size: 14px;
+}

stories/page.css

+.storybook-page {
+  margin: 0 auto;
+  padding: 48px 20px;
+  max-width: 600px;
+  color: #333;
+  font-size: 14px;
+  line-height: 24px;
+  font-family: 'Nunito Sans', 'Helvetica Neue', Helvetica, Arial, sans-serif;
+}
+
+.storybook-page h2 {
+  display: inline-block;
+  vertical-align: top;
+  margin: 0 0 4px;
+  font-weight: 700;
+  font-size: 32px;
+  line-height: 1;
+}
+
+.storybook-page p {
+  margin: 1em 0;
+}
+
+.storybook-page a {
+  color: inherit;
+}
+
+.storybook-page ul {
+  margin: 1em 0;
+  padding-left: 30px;
+}
+
+.storybook-page li {
+  margin-bottom: 8px;
+}
+
+.storybook-page .tip {
+  display: inline-block;
+  vertical-align: top;
+  margin-right: 10px;
+  border-radius: 1em;
+  background: #e7fdd8;
+  padding: 4px 12px;
+  color: #357a14;
+  font-weight: 700;
+  font-size: 11px;
+  line-height: 12px;
+}
+
+.storybook-page .tip-wrapper {
+  margin-top: 40px;
+  margin-bottom: 40px;
+  font-size: 13px;
+  line-height: 20px;
+}
+
+.storybook-page .tip-wrapper svg {
+  display: inline-block;
+  vertical-align: top;
+  margin-top: 3px;
+  margin-right: 4px;
+  width: 12px;
+  height: 12px;
+}
+
+.storybook-page .tip-wrapper svg path {
+  fill: #1ea7fd;
+}

tsconfig.json

+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}