From f1944924098d158dc070d366ff94a7604c26f8b9 Mon Sep 17 00:00:00 2001
From: KarenZita01 <karenzitaagbo@gmail.com>
Date: Sat, 25 Jul 2026 13:47:27 +0100
Subject: [PATCH 1/2] feat(seo): implement comprehensive SEO with Open Graph,
 structured data, sitemap, and metadata

- Add generateMetadata helper with title template and base URL
- Update layout with Open Graph and Twitter Card tags
- Create sitemap with static routes and priorities
- Create robots.txt with production rules
- Add JSON-LD structured data (WebApplication, Organization, BreadcrumbList)
- Add per-page metadata for all routes
- Create og-image.png placeholder
---
 app/billing/page.tsx    |  34 +++++++++++++++++
 app/dashboard/page.tsx  |  34 +++++++++++++++++
 app/layout.tsx          |  41 +++++++++++++++++++-
 app/meters/page.tsx     |  34 +++++++++++++++++
 app/page.tsx            |  82 +++++++++++++++++++++++++---------------
 app/robots.ts           |  26 +++++++++++++
 app/sitemap.ts          |  38 +++++++++++++++++++
 app/streams/page.tsx    |  34 +++++++++++++++++
 package-lock.json       |  24 ++++++++++--
 package.json            |   1 +
 public/og-image.png     | Bin 0 -> 9603 bytes
 src/lib/seo/json-ld.ts  |  50 ++++++++++++++++++++++++
 src/lib/seo/metadata.ts |  67 ++++++++++++++++++++++++++++++++
 13 files changed, 429 insertions(+), 36 deletions(-)
 create mode 100644 app/billing/page.tsx
 create mode 100644 app/dashboard/page.tsx
 create mode 100644 app/meters/page.tsx
 create mode 100644 app/robots.ts
 create mode 100644 app/sitemap.ts
 create mode 100644 app/streams/page.tsx
 create mode 100644 public/og-image.png
 create mode 100644 src/lib/seo/json-ld.ts
 create mode 100644 src/lib/seo/metadata.ts

diff --git a/app/billing/page.tsx b/app/billing/page.tsx
new file mode 100644
index 0000000..f98b413
--- /dev/null
+++ b/app/billing/page.tsx
@@ -0,0 +1,34 @@
+import { generateMetadata } from "@/src/lib/seo/metadata"
+import { breadcrumbListSchema } from "@/src/lib/seo/json-ld"
+
+export const metadata = generateMetadata({
+  title: "Billing",
+  description: "View billing history, manage payments, and track usage costs for your utility meters on EquipChain.",
+  path: "/billing",
+})
+
+export default function BillingPage() {
+  const jsonLd = breadcrumbListSchema([
+    { name: "Home", path: "/" },
+    { name: "Billing", path: "/billing" },
+  ])
+
+  return (
+    <>
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
+      />
+      <div className="flex min-h-screen items-center justify-center bg-zinc-50 dark:bg-black">
+        <main className="flex flex-col items-center gap-8 py-32 px-16">
+          <h1 className="text-4xl font-bold text-black dark:text-zinc-50">
+            Billing
+          </h1>
+          <p className="text-zinc-600 dark:text-zinc-400">
+            Billing content coming soon.
+          </p>
+        </main>
+      </div>
+    </>
+  )
+}
diff --git a/app/dashboard/page.tsx b/app/dashboard/page.tsx
new file mode 100644
index 0000000..efd85b4
--- /dev/null
+++ b/app/dashboard/page.tsx
@@ -0,0 +1,34 @@
+import { generateMetadata } from "@/src/lib/seo/metadata"
+import { breadcrumbListSchema } from "@/src/lib/seo/json-ld"
+
+export const metadata = generateMetadata({
+  title: "Dashboard",
+  description: "Overview of your utility meters, usage statistics, and recent activity on EquipChain.",
+  path: "/dashboard",
+})
+
+export default function DashboardPage() {
+  const jsonLd = breadcrumbListSchema([
+    { name: "Home", path: "/" },
+    { name: "Dashboard", path: "/dashboard" },
+  ])
+
+  return (
+    <>
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
+      />
+      <div className="flex min-h-screen items-center justify-center bg-zinc-50 dark:bg-black">
+        <main className="flex flex-col items-center gap-8 py-32 px-16">
+          <h1 className="text-4xl font-bold text-black dark:text-zinc-50">
+            Dashboard
+          </h1>
+          <p className="text-zinc-600 dark:text-zinc-400">
+            Dashboard content coming soon.
+          </p>
+        </main>
+      </div>
+    </>
+  )
+}
diff --git a/app/layout.tsx b/app/layout.tsx
index 62fd479..da1ab1b 100644
--- a/app/layout.tsx
+++ b/app/layout.tsx
@@ -2,6 +2,8 @@ import type { Metadata } from "next";
 import { Geist, Geist_Mono } from "next/font/google";
 import "./globals.css";
 
+const baseUrl = process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
+
 const geistSans = Geist({
   variable: "--font-geist-sans",
   subsets: ["latin"],
@@ -13,8 +15,43 @@ const geistMono = Geist_Mono({
 });
 
 export const metadata: Metadata = {
-  title: "Equipchain Dashboard",
-  description: "Next.js frontend dashboard for Equipchain utility management on Stellar Soroban",
+  metadataBase: new URL(baseUrl),
+  title: {
+    default: "EquipChain Dashboard",
+    template: "%s | EquipChain",
+  },
+  description:
+    "Utility metering and billing dashboard for monitoring meters, managing gas buffers, and tracking usage on Stellar Soroban.",
+  openGraph: {
+    title: "EquipChain Dashboard",
+    description:
+      "Utility metering and billing dashboard for monitoring meters, managing gas buffers, and tracking usage on Stellar Soroban.",
+    url: baseUrl,
+    siteName: "EquipChain",
+    type: "website",
+    locale: "en_US",
+    images: [
+      {
+        url: `${baseUrl}/og-image.png`,
+        width: 1200,
+        height: 630,
+        alt: "EquipChain Dashboard",
+      },
+    ],
+  },
+  twitter: {
+    card: "summary_large_image",
+    site: "@equipchain",
+    creator: "@equipchain",
+    title: "EquipChain Dashboard",
+    description:
+      "Utility metering and billing dashboard for monitoring meters, managing gas buffers, and tracking usage on Stellar Soroban.",
+    images: [`${baseUrl}/og-image.png`],
+  },
+  robots: {
+    index: true,
+    follow: true,
+  },
 };
 
 export default function RootLayout({
diff --git a/app/meters/page.tsx b/app/meters/page.tsx
new file mode 100644
index 0000000..408e9cf
--- /dev/null
+++ b/app/meters/page.tsx
@@ -0,0 +1,34 @@
+import { generateMetadata } from "@/src/lib/seo/metadata"
+import { breadcrumbListSchema } from "@/src/lib/seo/json-ld"
+
+export const metadata = generateMetadata({
+  title: "Meters",
+  description: "View and manage your utility meters, monitor consumption, and configure meter parameters on EquipChain.",
+  path: "/meters",
+})
+
+export default function MetersPage() {
+  const jsonLd = breadcrumbListSchema([
+    { name: "Home", path: "/" },
+    { name: "Meters", path: "/meters" },
+  ])
+
+  return (
+    <>
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
+      />
+      <div className="flex min-h-screen items-center justify-center bg-zinc-50 dark:bg-black">
+        <main className="flex flex-col items-center gap-8 py-32 px-16">
+          <h1 className="text-4xl font-bold text-black dark:text-zinc-50">
+            Meters
+          </h1>
+          <p className="text-zinc-600 dark:text-zinc-400">
+            Meters content coming soon.
+          </p>
+        </main>
+      </div>
+    </>
+  )
+}
diff --git a/app/page.tsx b/app/page.tsx
index 7c06070..a9bc8cc 100644
--- a/app/page.tsx
+++ b/app/page.tsx
@@ -1,34 +1,56 @@
+import { generateMetadata } from "@/src/lib/seo/metadata"
+import { breadcrumbListSchema, webApplicationSchema, organizationSchema } from "@/src/lib/seo/json-ld"
+
+export const metadata = generateMetadata({
+  title: "Home",
+  description:
+    "Utility metering and billing dashboard for monitoring meters, managing gas buffers, and tracking usage on Stellar Soroban.",
+  path: "/",
+})
+
 export default function Home() {
+  const jsonLd = {
+    ...webApplicationSchema(),
+    ...organizationSchema(),
+    ...breadcrumbListSchema([{ name: "Home", path: "/" }]),
+  }
+
   return (
-    <div className="flex min-h-screen items-center justify-center bg-zinc-50 font-sans dark:bg-black">
-      <main className="flex min-h-screen w-full max-w-3xl flex-col items-center justify-between py-32 px-16 bg-white dark:bg-black sm:items-start">
-        <div className="flex flex-col items-center gap-6 text-center sm:items-start sm:text-left">
-          <h1 className="max-w-xl text-4xl font-bold leading-12 tracking-tight text-black dark:text-zinc-50">
-            Equipchain Dashboard
-          </h1>
-          <p className="max-w-lg text-lg leading-8 text-zinc-600 dark:text-zinc-400">
-            Utility metering and billing dashboard for monitoring meters, managing gas buffers, and tracking usage on Stellar Soroban.
-          </p>
-        </div>
-        <div className="flex flex-col gap-4 text-base font-medium sm:flex-row">
-          <a
-            className="flex h-12 w-full items-center justify-center gap-2 rounded-full bg-foreground px-5 text-background transition-colors hover:bg-[#383838] dark:hover:bg-[#ccc] md:w-[158px]"
-            href="https://github.com/EquipChain/EquipChain-contracts"
-            target="_blank"
-            rel="noopener noreferrer"
-          >
-            View Contracts
-          </a>
-          <a
-            className="flex h-12 w-full items-center justify-center rounded-full border border-solid border-black/[.08] px-5 transition-colors hover:border-transparent hover:bg-black/[.04] dark:border-white/[.145] dark:hover:bg-[#1a1a1a] md:w-[158px]"
-            href="https://github.com/EquipChain/EquipChain-backend"
-            target="_blank"
-            rel="noopener noreferrer"
-          >
-            Backend API
-          </a>
-        </div>
-      </main>
-    </div>
+    <>
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
+      />
+      <div className="flex min-h-screen items-center justify-center bg-zinc-50 font-sans dark:bg-black">
+        <main className="flex min-h-screen w-full max-w-3xl flex-col items-center justify-between py-32 px-16 bg-white dark:bg-black sm:items-start">
+          <div className="flex flex-col items-center gap-6 text-center sm:items-start sm:text-left">
+            <h1 className="max-w-xl text-4xl font-bold leading-12 tracking-tight text-black dark:text-zinc-50">
+              Equipchain Dashboard
+            </h1>
+            <p className="max-w-lg text-lg leading-8 text-zinc-600 dark:text-zinc-400">
+              Utility metering and billing dashboard for monitoring meters, managing gas buffers, and tracking usage on Stellar Soroban.
+            </p>
+          </div>
+          <div className="flex flex-col gap-4 text-base font-medium sm:flex-row">
+            <a
+              className="flex h-12 w-full items-center justify-center gap-2 rounded-full bg-foreground px-5 text-background transition-colors hover:bg-[#383838] dark:hover:bg-[#ccc] md:w-[158px]"
+              href="https://github.com/EquipChain/EquipChain-contracts"
+              target="_blank"
+              rel="noopener noreferrer"
+            >
+              View Contracts
+            </a>
+            <a
+              className="flex h-12 w-full items-center justify-center rounded-full border border-solid border-black/[.08] px-5 transition-colors hover:border-transparent hover:bg-black/[.04] dark:border-white/[.145] dark:hover:bg-[#1a1a1a] md:w-[158px]"
+              href="https://github.com/EquipChain/EquipChain-backend"
+              target="_blank"
+              rel="noopener noreferrer"
+            >
+              Backend API
+            </a>
+          </div>
+        </main>
+      </div>
+    </>
   );
 }
diff --git a/app/robots.ts b/app/robots.ts
new file mode 100644
index 0000000..5228a34
--- /dev/null
+++ b/app/robots.ts
@@ -0,0 +1,26 @@
+import type { MetadataRoute } from "next"
+
+const baseUrl = process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000"
+const isProduction = process.env.NODE_ENV === "production"
+
+export default function robots(): MetadataRoute.Robots {
+  if (isProduction) {
+    return {
+      rules: [
+        {
+          userAgent: "*",
+          allow: "/",
+          disallow: ["/admin/", "/api/"],
+        },
+      ],
+      sitemap: `${baseUrl}/sitemap.xml`,
+    }
+  }
+
+  return {
+    rules: {
+      userAgent: "*",
+      disallow: "/",
+    },
+  }
+}
diff --git a/app/sitemap.ts b/app/sitemap.ts
new file mode 100644
index 0000000..0dd5760
--- /dev/null
+++ b/app/sitemap.ts
@@ -0,0 +1,38 @@
+import type { MetadataRoute } from "next"
+
+const baseUrl = process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000"
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  return [
+    {
+      url: baseUrl,
+      lastModified: new Date(),
+      changeFrequency: "monthly",
+      priority: 1,
+    },
+    {
+      url: `${baseUrl}/dashboard`,
+      lastModified: new Date(),
+      changeFrequency: "monthly",
+      priority: 0.9,
+    },
+    {
+      url: `${baseUrl}/meters`,
+      lastModified: new Date(),
+      changeFrequency: "weekly",
+      priority: 0.8,
+    },
+    {
+      url: `${baseUrl}/billing`,
+      lastModified: new Date(),
+      changeFrequency: "weekly",
+      priority: 0.7,
+    },
+    {
+      url: `${baseUrl}/streams`,
+      lastModified: new Date(),
+      changeFrequency: "weekly",
+      priority: 0.6,
+    },
+  ]
+}
diff --git a/app/streams/page.tsx b/app/streams/page.tsx
new file mode 100644
index 0000000..2ef9e92
--- /dev/null
+++ b/app/streams/page.tsx
@@ -0,0 +1,34 @@
+import { generateMetadata } from "@/src/lib/seo/metadata"
+import { breadcrumbListSchema } from "@/src/lib/seo/json-ld"
+
+export const metadata = generateMetadata({
+  title: "Streams",
+  description: "Monitor real-time data streams from your utility meters and view live usage feeds on EquipChain.",
+  path: "/streams",
+})
+
+export default function StreamsPage() {
+  const jsonLd = breadcrumbListSchema([
+    { name: "Home", path: "/" },
+    { name: "Streams", path: "/streams" },
+  ])
+
+  return (
+    <>
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
+      />
+      <div className="flex min-h-screen items-center justify-center bg-zinc-50 dark:bg-black">
+        <main className="flex flex-col items-center gap-8 py-32 px-16">
+          <h1 className="text-4xl font-bold text-black dark:text-zinc-50">
+            Streams
+          </h1>
+          <p className="text-zinc-600 dark:text-zinc-400">
+            Streams content coming soon.
+          </p>
+        </main>
+      </div>
+    </>
+  )
+}
diff --git a/package-lock.json b/package-lock.json
index a9f0e80..f294a0a 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -8,6 +8,7 @@
       "name": "temp-app",
       "version": "0.1.0",
       "dependencies": {
+        "@next/swc-win32-x64-msvc": "^16.2.11",
         "next": "16.1.6",
         "react": "19.2.3",
         "react-dom": "19.2.3"
@@ -1163,14 +1164,13 @@
       }
     },
     "node_modules/@next/swc-win32-x64-msvc": {
-      "version": "16.1.6",
-      "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-16.1.6.tgz",
-      "integrity": "sha512-NRfO39AIrzBnixKbjuo2YiYhB6o9d8v/ymU9m/Xk8cyVk+k7XylniXkHwjs4s70wedVffc6bQNbufk5v0xEm0A==",
+      "version": "16.2.11",
+      "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-16.2.11.tgz",
+      "integrity": "sha512-md8CLNggS1Dx9pUgApzps5uAf+N8GN9xywzmNx9vHAWo94HtBwCCqkSnhIrdfQe83Dhz8Lfo/20Nb1Zxal092w==",
       "cpu": [
         "x64"
       ],
       "license": "MIT",
-      "optional": true,
       "os": [
         "win32"
       ],
@@ -5001,6 +5001,22 @@
         }
       }
     },
+    "node_modules/next/node_modules/@next/swc-win32-x64-msvc": {
+      "version": "16.1.6",
+      "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-16.1.6.tgz",
+      "integrity": "sha512-NRfO39AIrzBnixKbjuo2YiYhB6o9d8v/ymU9m/Xk8cyVk+k7XylniXkHwjs4s70wedVffc6bQNbufk5v0xEm0A==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
     "node_modules/next/node_modules/postcss": {
       "version": "8.4.31",
       "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.31.tgz",
diff --git a/package.json b/package.json
index 05332e5..89e4287 100644
--- a/package.json
+++ b/package.json
@@ -9,6 +9,7 @@
     "lint": "eslint"
   },
   "dependencies": {
+    "@next/swc-win32-x64-msvc": "^16.2.11",
     "next": "16.1.6",
     "react": "19.2.3",
     "react-dom": "19.2.3"
diff --git a/public/og-image.png b/public/og-image.png
new file mode 100644
index 0000000000000000000000000000000000000000..28b5f82c36e73b811205492f073cedaaa3103d04
GIT binary patch
literal 9603
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%0AB;qmk55y5KE0IPz#(
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

literal 0
HcmV?d00001

diff --git a/src/lib/seo/json-ld.ts b/src/lib/seo/json-ld.ts
new file mode 100644
index 0000000..f8f5edf
--- /dev/null
+++ b/src/lib/seo/json-ld.ts
@@ -0,0 +1,50 @@
+const baseUrl =
+  process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000"
+
+export function webApplicationSchema() {
+  return {
+    "@context": "https://schema.org",
+    "@type": "WebApplication",
+    name: "EquipChain Dashboard",
+    url: baseUrl,
+    applicationCategory: "BusinessApplication",
+    operatingSystem: "Web",
+    description:
+      "Utility metering and billing dashboard for monitoring meters, managing gas buffers, and tracking usage on Stellar Soroban.",
+    browserRequirements: "Requires modern browser with JavaScript enabled",
+  }
+}
+
+export function organizationSchema() {
+  return {
+    "@context": "https://schema.org",
+    "@type": "Organization",
+    name: "EquipChain",
+    url: baseUrl,
+    description:
+      "Decentralized utility metering and billing platform on Stellar Soroban",
+    contactPoint: {
+      "@type": "ContactPoint",
+      contactType: "support",
+      url: `${baseUrl}/contact`,
+    },
+    sameAs: [
+      "https://github.com/EquipChain",
+      "https://github.com/EquipChain/EquipChain-contracts",
+      "https://github.com/EquipChain/EquipChain-backend",
+    ],
+  }
+}
+
+export function breadcrumbListSchema(items: { name: string; path: string }[]) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    itemListElement: items.map((item, index) => ({
+      "@type": "ListItem",
+      position: index + 1,
+      name: item.name,
+      item: `${baseUrl}${item.path}`,
+    })),
+  }
+}
diff --git a/src/lib/seo/metadata.ts b/src/lib/seo/metadata.ts
new file mode 100644
index 0000000..7e55074
--- /dev/null
+++ b/src/lib/seo/metadata.ts
@@ -0,0 +1,67 @@
+import type { Metadata } from "next"
+
+const baseUrl = process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000"
+
+const titleTemplate = "%s | EquipChain"
+
+export const defaultMetadata: Metadata = {
+  metadataBase: new URL(baseUrl),
+  title: {
+    default: "EquipChain Dashboard",
+    template: titleTemplate,
+  },
+  description:
+    "Utility metering and billing dashboard for monitoring meters, managing gas buffers, and tracking usage on Stellar Soroban.",
+  openGraph: {
+    type: "website",
+    siteName: "EquipChain",
+    title: "EquipChain Dashboard",
+    description:
+      "Utility metering and billing dashboard for monitoring meters, managing gas buffers, and tracking usage on Stellar Soroban.",
+    url: baseUrl,
+    locale: "en_US",
+  },
+  twitter: {
+    card: "summary_large_image",
+    site: "@equipchain",
+    creator: "@equipchain",
+  },
+  robots: {
+    index: true,
+    follow: true,
+  },
+}
+
+export function generateMetadata({
+  title,
+  description,
+  path,
+  image,
+}: {
+  title: string
+  description?: string
+  path?: string
+  image?: string
+}): Metadata {
+  const url = path ? `${baseUrl}${path}` : baseUrl
+  const images = image
+    ? [{ url: image, width: 1200, height: 630, alt: title }]
+    : undefined
+
+  return {
+    title,
+    description,
+    alternates: { canonical: url },
+    openGraph: {
+      title,
+      description,
+      url,
+      images,
+    },
+    twitter: {
+      title,
+      description,
+      images: images ? images.map((i) => i.url) : undefined,
+    },
+  }
+}

From a0c505e874171d0584d643615bb517338d4df97f Mon Sep 17 00:00:00 2001
From: KarenZita01 <karenzitaagbo@gmail.com>
Date: Sat, 25 Jul 2026 15:58:40 +0100
Subject: [PATCH 2/2] feat: implement comprehensive SEO with Open Graph,
 structured data, sitemap, and metadata

- Create src/lib/seo/metadata.ts with generateMetadata helper
- Add Open Graph and Twitter Card tags to layout metadata
- Create app/sitemap.ts with static routes
- Create app/robots.ts with crawler rules
- Create src/lib/seo/json-ld.ts with structured data schemas
- Add per-page metadata to all routes
- Fix package.json and package-lock.json for Linux CI compatibility

Closes #23
---
 package-lock.json | 24 ++++--------------------
 package.json      |  1 -
 2 files changed, 4 insertions(+), 21 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index f294a0a..a9f0e80 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -8,7 +8,6 @@
       "name": "temp-app",
       "version": "0.1.0",
       "dependencies": {
-        "@next/swc-win32-x64-msvc": "^16.2.11",
         "next": "16.1.6",
         "react": "19.2.3",
         "react-dom": "19.2.3"
@@ -1164,13 +1163,14 @@
       }
     },
     "node_modules/@next/swc-win32-x64-msvc": {
-      "version": "16.2.11",
-      "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-16.2.11.tgz",
-      "integrity": "sha512-md8CLNggS1Dx9pUgApzps5uAf+N8GN9xywzmNx9vHAWo94HtBwCCqkSnhIrdfQe83Dhz8Lfo/20Nb1Zxal092w==",
+      "version": "16.1.6",
+      "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-16.1.6.tgz",
+      "integrity": "sha512-NRfO39AIrzBnixKbjuo2YiYhB6o9d8v/ymU9m/Xk8cyVk+k7XylniXkHwjs4s70wedVffc6bQNbufk5v0xEm0A==",
       "cpu": [
         "x64"
       ],
       "license": "MIT",
+      "optional": true,
       "os": [
         "win32"
       ],
@@ -5001,22 +5001,6 @@
         }
       }
     },
-    "node_modules/next/node_modules/@next/swc-win32-x64-msvc": {
-      "version": "16.1.6",
-      "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-16.1.6.tgz",
-      "integrity": "sha512-NRfO39AIrzBnixKbjuo2YiYhB6o9d8v/ymU9m/Xk8cyVk+k7XylniXkHwjs4s70wedVffc6bQNbufk5v0xEm0A==",
-      "cpu": [
-        "x64"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">= 10"
-      }
-    },
     "node_modules/next/node_modules/postcss": {
       "version": "8.4.31",
       "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.31.tgz",
diff --git a/package.json b/package.json
index 89e4287..05332e5 100644
--- a/package.json
+++ b/package.json
@@ -9,7 +9,6 @@
     "lint": "eslint"
   },
   "dependencies": {
-    "@next/swc-win32-x64-msvc": "^16.2.11",
     "next": "16.1.6",
     "react": "19.2.3",
     "react-dom": "19.2.3"