From 19935a46f9037bf952ea4ad62a76f36a7960a82d Mon Sep 17 00:00:00 2001
From: hopcy-forcy <hopcy.forcy@gmail.com>
Date: Sat, 9 Aug 2025 16:27:00 +0100
Subject: [PATCH 1/3] fix(header): hide search button and adjust hr visibility
 for better layout

---
 src/app/docs/layout.tsx          | 30 +++++++++++
 src/app/layout.tsx               | 86 ++++++++++++++++++++++++++++++--
 src/app/manifest.webmanifest     | 17 +++++++
 src/app/page.tsx                 |  5 ++
 src/app/robots.ts                | 17 +++++++
 src/app/sitemap.ts               | 61 ++++++++++++++++++++++
 src/components/(home)/header.tsx |  3 +-
 7 files changed, 215 insertions(+), 4 deletions(-)
 create mode 100644 src/app/manifest.webmanifest
 create mode 100644 src/app/robots.ts
 create mode 100644 src/app/sitemap.ts

diff --git a/src/app/docs/layout.tsx b/src/app/docs/layout.tsx
index bc6a42c6..aa63e26c 100644
--- a/src/app/docs/layout.tsx
+++ b/src/app/docs/layout.tsx
@@ -1,3 +1,8 @@
+import type { Metadata } from "next";
+import Script from "next/script";
+export const metadata: Metadata = {
+  alternates: { canonical: "/docs" },
+};
 import { SideBar } from "@/components/(home)/sideBar";
 import { dm_sans } from "@/font/google";
 
@@ -16,6 +21,31 @@ const DocsLayout = ({ children }: { children: React.ReactNode }) => {
                 {/* <span className="  absolute -z-20  right-2 bottom-2 rounded-full blur-2xl  size-10 bg-yellow-100 "></span> */}
 
                 {children}
+                <Script
+                  id="ld-json-breadcrumb"
+                  type="application/ld+json"
+                  strategy="afterInteractive"
+                  dangerouslySetInnerHTML={{
+                    __html: JSON.stringify({
+                      "@context": "https://schema.org",
+                      "@type": "BreadcrumbList",
+                      itemListElement: [
+                        {
+                          "@type": "ListItem",
+                          position: 1,
+                          name: "Home",
+                          item: "/"
+                        },
+                        {
+                          "@type": "ListItem",
+                          position: 2,
+                          name: "Docs",
+                          item: "/docs"
+                        }
+                      ]
+                    })
+                  }}
+                />
             </aside>
 
             <style>
diff --git a/src/app/layout.tsx b/src/app/layout.tsx
index 9cb25e2c..c938d694 100644
--- a/src/app/layout.tsx
+++ b/src/app/layout.tsx
@@ -1,4 +1,5 @@
 import type { Metadata } from "next";
+import Script from "next/script";
 import { Analytics } from "@vercel/analytics/react"
 import "./globals.css";
 import { inter, jetbrainsMono } from "@/font/google";
@@ -8,9 +9,74 @@ import { LightDark } from "@/components/(home)/lightDark";
 import { Language } from "@/components/(home)/language";
 import { MenuModal } from "@/components/(home)/menu.modal";
 
+const siteUrl = process.env.NEXT_PUBLIC_SITE_URL || "http://localhost:3000";
+const siteName = "Nexy";
+const siteDescription =
+  "Nexy is a modern, fast, and secure framework for building web applications with Python.";
+
 export const metadata: Metadata = {
-  title: "Nexy",
-  description: "Nexy is a modern, fast, and secure framework for building web applications with Python.",
+  metadataBase: new URL(siteUrl),
+  applicationName: `${siteName} Docs`,
+  title: {
+    default: siteName,
+    template: `%s | ${siteName}`,
+  },
+  description: siteDescription,
+  keywords: [
+    "Nexy",
+    "Nexy framework",
+    "Python web framework",
+    "fast python",
+    "secure python",
+    "docs",
+  ],
+  authors: [{ name: siteName }],
+  creator: siteName,
+  publisher: siteName,
+  category: "technology",
+  robots: {
+    index: true,
+    follow: true,
+    googleBot: {
+      index: true,
+      follow: true,
+      "max-image-preview": "large",
+      "max-snippet": -1,
+      "max-video-preview": -1,
+    },
+  },
+  openGraph: {
+    type: "website",
+    url: siteUrl,
+    title: siteName,
+    siteName,
+    description: siteDescription,
+    locale: "en_US",
+    images: [
+      {
+        url: "/nexy.jpg",
+        width: 1200,
+        height: 630,
+        alt: siteName,
+      },
+    ],
+  },
+  twitter: {
+    card: "summary_large_image",
+    title: siteName,
+    description: siteDescription,
+    images: ["/nexy.jpg"],
+  },
+  // Canonicals will be set per page where needed to avoid a site-wide root canonical
+  icons: {
+    icon: [{ url: "/favicon.ico" }],
+  },
+  themeColor: [{ media: "(prefers-color-scheme: dark)", color: "#0E201B" }],
+  viewport: {
+    width: "device-width",
+    initialScale: 1,
+    maximumScale: 5,
+  },
 };
 
 
@@ -22,11 +88,25 @@ export default function RootLayout({
 }>) {
   return (
     <html lang="en" className="scroll-smooth light">
-      <meta name="theme-color" content="#0E201B" />
 
       <body
         className={`${inter.variable} ${jetbrainsMono.variable} flex flex-col justify-between overflow-x-hidden min-h-dvh antialiased `}
       >
+        <Script
+          id="ld-json-website"
+          type="application/ld+json"
+          strategy="beforeInteractive"
+          dangerouslySetInnerHTML={{
+            __html: JSON.stringify({
+              "@context": "https://schema.org",
+              "@type": "WebSite",
+              name: siteName,
+              url: siteUrl,
+              description: siteDescription,
+              inLanguage: "en",
+            }),
+          }}
+        />
 
         <Header />
         <div className="h-16 md:hidden"></div>
diff --git a/src/app/manifest.webmanifest b/src/app/manifest.webmanifest
new file mode 100644
index 00000000..265a8d7b
--- /dev/null
+++ b/src/app/manifest.webmanifest
@@ -0,0 +1,17 @@
+{
+  "name": "Nexy Docs",
+  "short_name": "Nexy",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#0E201B",
+  "theme_color": "#0E201B",
+  "icons": [
+    {
+      "src": "/favicon.ico",
+      "sizes": "64x64 32x32 24x24 16x16",
+      "type": "image/x-icon"
+    }
+  ]
+}
+
+
diff --git a/src/app/page.tsx b/src/app/page.tsx
index 49e6e849..934213dd 100644
--- a/src/app/page.tsx
+++ b/src/app/page.tsx
@@ -1,3 +1,8 @@
+import type { Metadata } from "next";
+
+export const metadata: Metadata = {
+  alternates: { canonical: "/" },
+};
 import { HeroSection } from "@/components/(home)/heroSection";
 
 const HomePage = () => {
diff --git a/src/app/robots.ts b/src/app/robots.ts
new file mode 100644
index 00000000..731b5978
--- /dev/null
+++ b/src/app/robots.ts
@@ -0,0 +1,17 @@
+import type { MetadataRoute } from "next";
+
+export default function robots(): MetadataRoute.Robots {
+  const siteUrl = process.env.NEXT_PUBLIC_SITE_URL || "http://localhost:3000";
+
+  return {
+    rules: {
+      userAgent: "*",
+      allow: "/",
+      disallow: ["/api/"],
+    },
+    sitemap: `${siteUrl}/sitemap.xml`,
+    host: siteUrl,
+  };
+}
+
+
diff --git a/src/app/sitemap.ts b/src/app/sitemap.ts
new file mode 100644
index 00000000..7112539c
--- /dev/null
+++ b/src/app/sitemap.ts
@@ -0,0 +1,61 @@
+import fs from "node:fs";
+import path from "node:path";
+import type { MetadataRoute } from "next";
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const siteUrl = process.env.NEXT_PUBLIC_SITE_URL || "http://localhost:3000";
+
+  // Discover static routes: read app dir and include directories with page files
+  const appDir = path.join(process.cwd(), "src", "app");
+  const staticPaths: string[] = [];
+
+  const walk = (dir: string, baseUrl = "") => {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.name.startsWith("(") || entry.name.startsWith("_")) continue; // skip group/privates
+      const full = path.join(dir, entry.name);
+      const currentUrl = path.posix.join(baseUrl, entry.name);
+      if (entry.isDirectory()) {
+        // if directory contains page.tsx/mdx, add it
+        const hasPage = [
+          path.join(full, "page.tsx"),
+          path.join(full, "page.mdx"),
+          path.join(full, "page.jsx"),
+          path.join(full, "page.ts"),
+        ].some(fs.existsSync);
+
+        if (hasPage) {
+          staticPaths.push("/" + currentUrl.replace(/\\\\/g, "/"));
+        }
+        walk(full, currentUrl);
+      } else if (/^page\.(tsx|jsx|mdx|ts)$/.test(entry.name) && baseUrl) {
+        staticPaths.push("/" + baseUrl.replace(/\\\\/g, "/"));
+      }
+    }
+  };
+
+  walk(appDir);
+
+  // Add root explicitly if exists
+  const rootPageCandidates = [
+    path.join(appDir, "page.tsx"),
+    path.join(appDir, "page.ts"),
+    path.join(appDir, "page.jsx"),
+    path.join(appDir, "page.mdx"),
+  ];
+  if (rootPageCandidates.some(fs.existsSync)) staticPaths.push("/");
+
+  // Remove dynamic and API routes
+  const filtered = Array.from(new Set(staticPaths))
+    .filter((p) => !p.includes("["))
+    .filter((p) => !p.startsWith("/api"));
+
+  return filtered.map((p) => ({
+    url: `${siteUrl}${p}`,
+    lastModified: new Date(),
+    changeFrequency: p === "/" ? "weekly" : "monthly",
+    priority: p === "/" ? 1 : p.split("/").length <= 2 ? 0.8 : 0.6,
+  }));
+}
+
+
diff --git a/src/components/(home)/header.tsx b/src/components/(home)/header.tsx
index 7cb883ca..8409f74d 100644
--- a/src/components/(home)/header.tsx
+++ b/src/components/(home)/header.tsx
@@ -21,12 +21,13 @@ const Header = () => {
             </div>
             <menu className=" hidden md:flex gap-6 items-center ">
                 <button
+                    hidden
                     className="hover:scale-104 transition-all duration-300 flex gap-2 justify-center items-center  pl-2 pr-4 py-1 rounded-xl text-sm text-gray-50/70 border border-[#A9FFEA]/6 bg-[#A9FFEA]/5 hover:bg-[#A9FFEA]/10 cursor-pointer "
                 >
                     <Search />
                     <code>ctr k</code>
                 </button>
-                <hr className="hidden md:block h-2 border border-dashed border-gray-50/15" />
+                <hr hidden className="hidden md:block h-2 border border-dashed border-gray-50/15" />
                 <NavLink />
                 <hr className="hidden md:block h-2 border border-dashed border-gray-50/15 " />
                 <Link

From f58a5e65a20bf03418426acd6dc4487b25383445 Mon Sep 17 00:00:00 2001
From: hopcy-forcy <hopcy.forcy@gmail.com>
Date: Sat, 9 Aug 2025 16:42:19 +0100
Subject: [PATCH 2/3] feat(config): enhance Next.js configuration with security
 headers, redirects, and image optimization

- Added security headers for improved protection against common vulnerabilities.
- Implemented redirects for better user navigation from old documentation paths.
- Configured image optimization settings for better performance.
- Introduced a new browser configuration file for enhanced compatibility with Microsoft browsers.
- Updated metadata and structured data across various pages for improved SEO and clarity.
---
 next.config.ts               |  88 +++++++++++++++++++++++++--
 public/browserconfig.xml     |   9 +++
 src/app/docs/layout.tsx      | 102 +++++++++++++++++++++++--------
 src/app/layout.tsx           | 113 +++++++++++++++++++++++++++++++----
 src/app/manifest.ts          |  47 +++++++++++++++
 src/app/manifest.webmanifest |  17 ------
 src/app/page.tsx             |  65 +++++++++++++++++++-
 src/app/robots.ts            |  31 ++++++++--
 8 files changed, 404 insertions(+), 68 deletions(-)
 create mode 100644 public/browserconfig.xml
 create mode 100644 src/app/manifest.ts
 delete mode 100644 src/app/manifest.webmanifest

diff --git a/next.config.ts b/next.config.ts
index ec2f55f6..bd6a04dc 100644
--- a/next.config.ts
+++ b/next.config.ts
@@ -1,18 +1,96 @@
 /* eslint-disable @typescript-eslint/no-require-imports */
 import type { NextConfig } from "next";
-const  createMDX = require('@next/mdx');
+const createMDX = require('@next/mdx');
 
 const nextConfig: NextConfig = {
-  /* config options here */
   pageExtensions: ['js', 'jsx', 'md', 'mdx', 'ts', 'tsx'],
-  
-
+  experimental: {
+    optimizePackageImports: ["@vercel/analytics"],
+  },
+  async headers() {
+    return [
+      {
+        source: "/(.*)",
+        headers: [
+          {
+            key: "X-Content-Type-Options",
+            value: "nosniff",
+          },
+          {
+            key: "X-Frame-Options",
+            value: "DENY",
+          },
+          {
+            key: "X-XSS-Protection",
+            value: "1; mode=block",
+          },
+          {
+            key: "Referrer-Policy",
+            value: "strict-origin-when-cross-origin",
+          },
+          {
+            key: "Permissions-Policy",
+            value: "camera=(), microphone=(), geolocation=()",
+          },
+        ],
+      },
+      {
+        source: "/docs/(.*)",
+        headers: [
+          {
+            key: "Cache-Control",
+            value: "public, max-age=3600, stale-while-revalidate=86400",
+          },
+        ],
+      },
+      {
+        source: "/sitemap.xml",
+        headers: [
+          {
+            key: "Cache-Control",
+            value: "public, max-age=3600, stale-while-revalidate=86400",
+          },
+        ],
+      },
+      {
+        source: "/robots.txt",
+        headers: [
+          {
+            key: "Cache-Control",
+            value: "public, max-age=3600, stale-while-revalidate=86400",
+          },
+        ],
+      },
+    ];
+  },
+  async redirects() {
+    return [
+      {
+        source: "/documentation",
+        destination: "/docs",
+        permanent: true,
+      },
+      {
+        source: "/guide",
+        destination: "/docs",
+        permanent: true,
+      },
+    ];
+  },
+  images: {
+    formats: ["image/webp", "image/avif"],
+    deviceSizes: [640, 750, 828, 1080, 1200, 1920, 2048, 3840],
+    imageSizes: [16, 32, 48, 64, 96, 128, 256, 384],
+  },
+  compress: true,
+  poweredByHeader: false,
+  generateEtags: true,
 };
 
 const withMDX = createMDX({
   // Add markdown plugins here, as desired
 })
- 
+
 // Merge MDX config with Next.js config
 export default withMDX(nextConfig)
 
diff --git a/public/browserconfig.xml b/public/browserconfig.xml
new file mode 100644
index 00000000..ceb1d86b
--- /dev/null
+++ b/public/browserconfig.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<browserconfig>
+    <msapplication>
+        <tile>
+            <square150x150logo src="/nexy.svg"/>
+            <TileColor>#0E201B</TileColor>
+        </tile>
+    </msapplication>
+</browserconfig>
diff --git a/src/app/docs/layout.tsx b/src/app/docs/layout.tsx
index aa63e26c..335e5330 100644
--- a/src/app/docs/layout.tsx
+++ b/src/app/docs/layout.tsx
@@ -1,51 +1,101 @@
+import { SideBar } from "@/components/(home)/sideBar";
+import { dm_sans } from "@/font/google";
 import type { Metadata } from "next";
 import Script from "next/script";
+
+const siteUrl = process.env.NEXT_PUBLIC_SITE_URL || "http://localhost:3000";
+
 export const metadata: Metadata = {
-  alternates: { canonical: "/docs" },
+  title: "Documentation",
+  description: "Complete documentation for Nexy framework - Learn how to build modern web applications with Python and FastAPI.",
+  keywords: [
+    "Nexy documentation",
+    "Python framework docs",
+    "FastAPI documentation",
+    "Web development guide",
+    "API development tutorial",
+  ],
+  openGraph: {
+    title: "Nexy Documentation",
+    description: "Complete documentation for Nexy framework - Learn how to build modern web applications with Python and FastAPI.",
+    type: "website",
+    url: `${siteUrl}/docs`,
+  },
+  twitter: {
+    title: "Nexy Documentation",
+    description: "Complete documentation for Nexy framework - Learn how to build modern web applications with Python and FastAPI.",
+  },
+  alternates: {
+    canonical: `${siteUrl}/docs`,
+  },
 };
-import { SideBar } from "@/components/(home)/sideBar";
-import { dm_sans } from "@/font/google";
 
 const DocsLayout = ({ children }: { children: React.ReactNode }) => {
     return (
-
         <section className="sticky top-0  md:flex flex-row   md:mx-14 md:border-x border-dashed border-gray-50/15 ">
             <SideBar hidden={true} />
             <aside
                 className="relative p-3 md:p-15 md:flex-2   md:border-l border-dashed border-gray-50/15  mdx"
             >
-                {/* <span className="  absolute left-2 -z-20 top-2 rounded-full blur-3xl  size-16 bg-white/50  "></span> */}
-                {/* <span className="  absolute -z-20  left-2 bottom-2 rounded-full blur-2xl  size-10 bg-gray-50 "></span> */}
-
-                {/* <span className="  absolute -z-20  right-2 top-2 rounded-full blur-2xl  size-10 bg-[#A9F5FF] "></span> */}
-                {/* <span className="  absolute -z-20  right-2 bottom-2 rounded-full blur-2xl  size-10 bg-yellow-100 "></span> */}
-
-                {children}
+                {/* Structured Data - Documentation */}
                 <Script
-                  id="ld-json-breadcrumb"
+                  id="ld-json-documentation"
                   type="application/ld+json"
-                  strategy="afterInteractive"
+                  strategy="beforeInteractive"
                   dangerouslySetInnerHTML={{
                     __html: JSON.stringify({
                       "@context": "https://schema.org",
-                      "@type": "BreadcrumbList",
-                      itemListElement: [
+                      "@type": "TechArticle",
+                      headline: "Nexy Framework Documentation",
+                      description: "Complete documentation for Nexy framework - Learn how to build modern web applications with Python and FastAPI.",
+                      author: {
+                        "@type": "Organization",
+                        name: "Nexy",
+                        url: siteUrl,
+                      },
+                      publisher: {
+                        "@type": "Organization",
+                        name: "Nexy",
+                        logo: {
+                          "@type": "ImageObject",
+                          url: `${siteUrl}/nexy.svg`,
+                        },
+                      },
+                      datePublished: "2024-01-01",
+                      dateModified: new Date().toISOString().split("T")[0],
+                      mainEntityOfPage: {
+                        "@type": "WebPage",
+                        "@id": `${siteUrl}/docs`,
+                      },
+                      about: [
+                        {
+                          "@type": "Thing",
+                          name: "Python Web Framework",
+                        },
                         {
-                          "@type": "ListItem",
-                          position: 1,
-                          name: "Home",
-                          item: "/"
+                          "@type": "Thing",
+                          name: "FastAPI",
                         },
                         {
-                          "@type": "ListItem",
-                          position: 2,
-                          name: "Docs",
-                          item: "/docs"
-                        }
-                      ]
-                    })
+                          "@type": "Thing",
+                          name: "Web Development",
+                        },
+                      ],
+                      audience: {
+                        "@type": "Audience",
+                        audienceType: "Developers",
+                      },
+                    }),
                   }}
                 />
+
+                {/* <span className="  absolute left-2 -z-20 top-2 rounded-full blur-3xl  size-16 bg-white/50  "></span> */}
+                {/* <span className="  absolute -z-20  left-2 bottom-2 rounded-full blur-2xl  size-10 bg-gray-50 "></span> */}
+
+                {/* <span className="  absolute -z-20  right-2 top-2 rounded-full blur-2xl  size-10 bg-[#A9F5FF] "></span> */}
+                {/* <span className="  absolute -z-20  right-2 bottom-2 rounded-full blur-2xl  size-10 bg-yellow-100 "></span> */}
+
+                {children}
             </aside>
 
             <style>
diff --git a/src/app/layout.tsx b/src/app/layout.tsx
index c938d694..a89cc213 100644
--- a/src/app/layout.tsx
+++ b/src/app/layout.tsx
@@ -12,28 +12,35 @@ import { MenuModal } from "@/components/(home)/menu.modal";
 const siteUrl = process.env.NEXT_PUBLIC_SITE_URL || "http://localhost:3000";
 const siteName = "Nexy";
 const siteDescription =
-  "Nexy is a modern, fast, and secure framework for building web applications with Python.";
+  "Nexy is a modern, fast, and secure framework for building web applications with Python. Built on FastAPI for exceptional performance and developer experience.";
 
 export const metadata: Metadata = {
   metadataBase: new URL(siteUrl),
-  applicationName: `${siteName} Docs`,
+  applicationName: `${siteName} Documentation`,
   title: {
     default: siteName,
-    template: `%s | ${siteName}`,
+    template: `%s | ${siteName} Documentation`,
   },
   description: siteDescription,
   keywords: [
     "Nexy",
     "Nexy framework",
     "Python web framework",
-    "fast python",
-    "secure python",
-    "docs",
+    "FastAPI",
+    "Python development",
+    "Web development",
+    "API development",
+    "Python backend",
+    "Modern web framework",
+    "High performance Python",
+    "Developer tools",
+    "Documentation",
   ],
-  authors: [{ name: siteName }],
+  authors: [{ name: siteName, url: siteUrl }],
   creator: siteName,
   publisher: siteName,
   category: "technology",
+  classification: "Web Development Framework",
   robots: {
     index: true,
     follow: true,
@@ -57,7 +64,8 @@ export const metadata: Metadata = {
         url: "/nexy.jpg",
         width: 1200,
         height: 630,
-        alt: siteName,
+        alt: `${siteName} - Modern Python Web Framework`,
+        type: "image/jpeg",
       },
     ],
   },
@@ -66,21 +74,41 @@ export const metadata: Metadata = {
     title: siteName,
     description: siteDescription,
     images: ["/nexy.jpg"],
+    creator: "@nexyframework",
+    site: "@nexyframework",
+  },
+  alternates: {
+    canonical: siteUrl,
+    languages: {
+      "en-US": siteUrl,
+    },
   },
-  // Canonicals will be set per page where needed to avoid a site-wide root canonical
   icons: {
-    icon: [{ url: "/favicon.ico" }],
+    icon: [
+      { url: "/favicon.ico", sizes: "any" },
+      { url: "/nexy.svg", type: "image/svg+xml" },
+    ],
+    apple: "/nexy.svg",
   },
-  themeColor: [{ media: "(prefers-color-scheme: dark)", color: "#0E201B" }],
+  themeColor: [
+    { media: "(prefers-color-scheme: light)", color: "#0E201B" },
+    { media: "(prefers-color-scheme: dark)", color: "#0E201B" },
+  ],
   viewport: {
     width: "device-width",
     initialScale: 1,
     maximumScale: 5,
+    userScalable: true,
+  },
+  verification: {
+    google: process.env.GOOGLE_SITE_VERIFICATION,
+  },
+  other: {
+    "msapplication-TileColor": "#0E201B",
+    "msapplication-config": "/browserconfig.xml",
   },
 };
 
-
-
 export default function RootLayout({
   children,
 }: Readonly<{
@@ -88,10 +116,43 @@ export default function RootLayout({
 }>) {
   return (
     <html lang="en" className="scroll-smooth light">
+      <head>
+        <link rel="preconnect" href="https://fonts.googleapis.com" />
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossOrigin="anonymous" />
+        <link rel="dns-prefetch" href="//www.google-analytics.com" />
+        <link rel="dns-prefetch" href="//www.googletagmanager.com" />
+      </head>
 
       <body
         className={`${inter.variable} ${jetbrainsMono.variable} flex flex-col justify-between overflow-x-hidden min-h-dvh antialiased `}
       >
+        {/* Structured Data - Organization */}
+        <Script
+          id="ld-json-organization"
+          type="application/ld+json"
+          strategy="beforeInteractive"
+          dangerouslySetInnerHTML={{
+            __html: JSON.stringify({
+              "@context": "https://schema.org",
+              "@type": "Organization",
+              name: siteName,
+              url: siteUrl,
+              description: siteDescription,
+              logo: `${siteUrl}/nexy.svg`,
+              sameAs: [
+                "https://github.com/nexyframework",
+                "https://twitter.com/nexyframework",
+              ],
+              contactPoint: {
+                "@type": "ContactPoint",
+                contactType: "customer service",
+                availableLanguage: "English",
+              },
+            }),
+          }}
+        />
+
+        {/* Structured Data - WebSite */}
         <Script
           id="ld-json-website"
           type="application/ld+json"
@@ -104,6 +165,32 @@ export default function RootLayout({
               url: siteUrl,
               description: siteDescription,
               inLanguage: "en",
+              potentialAction: {
+                "@type": "SearchAction",
+                target: `${siteUrl}/search?q={search_term_string}`,
+                "query-input": "required name=search_term_string",
+              },
+            }),
+          }}
+        />
+
+        {/* Structured Data - SoftwareApplication */}
+        <Script
+          id="ld-json-software"
+          type="application/ld+json"
+          strategy="beforeInteractive"
+          dangerouslySetInnerHTML={{
+            __html: JSON.stringify({
+              "@context": "https://schema.org",
+              "@type": "SoftwareApplication",
+              name: siteName,
+              description: siteDescription,
+              applicationCategory: "DeveloperApplication",
+              operatingSystem: "Any",
+              programmingLanguage: "Python",
+              softwareVersion: "1.0.0",
+              downloadUrl: "https://github.com/nexyframework/nexy",
+              url: siteUrl,
             }),
           }}
         />
diff --git a/src/app/manifest.ts b/src/app/manifest.ts
new file mode 100644
index 00000000..5511b346
--- /dev/null
+++ b/src/app/manifest.ts
@@ -0,0 +1,47 @@
+import { MetadataRoute } from "next";
+
+export default function manifest(): MetadataRoute.Manifest {
+  return {
+    name: "Nexy Documentation",
+    short_name: "Nexy Docs",
+    description: "Complete documentation for Nexy framework - Learn how to build modern web applications with Python and FastAPI.",
+    start_url: "/",
+    display: "standalone",
+    background_color: "#0E201B",
+    theme_color: "#0E201B",
+    orientation: "portrait-primary",
+    scope: "/",
+    lang: "en",
+    categories: ["developer", "education", "productivity"],
+    icons: [
+      {
+        src: "/nexy.svg",
+        sizes: "any",
+        type: "image/svg+xml",
+        purpose: "any",
+      },
+      {
+        src: "/nexy.svg",
+        sizes: "192x192",
+        type: "image/svg+xml",
+      
+        purpose: "maskable",
+      },
+      {
+        src: "/nexy.svg",
+        sizes: "512x512",
+        type: "image/svg+xml",
+        purpose: "maskable",
+      },
+    ],
+    screenshots: [
+      {
+        src: "/nexy.jpg",
+        sizes: "1200x630",
+        type: "image/jpeg",
+        form_factor: "wide",
+        label: "Nexy Framework Documentation",
+      },
+    ],
+  };
+}
diff --git a/src/app/manifest.webmanifest b/src/app/manifest.webmanifest
deleted file mode 100644
index 265a8d7b..00000000
--- a/src/app/manifest.webmanifest
+++ /dev/null
@@ -1,17 +0,0 @@
-{
-  "name": "Nexy Docs",
-  "short_name": "Nexy",
-  "start_url": "/",
-  "display": "standalone",
-  "background_color": "#0E201B",
-  "theme_color": "#0E201B",
-  "icons": [
-    {
-      "src": "/favicon.ico",
-      "sizes": "64x64 32x32 24x24 16x16",
-      "type": "image/x-icon"
-    }
-  ]
-}
-
-
diff --git a/src/app/page.tsx b/src/app/page.tsx
index 934213dd..2401eae7 100644
--- a/src/app/page.tsx
+++ b/src/app/page.tsx
@@ -1,13 +1,74 @@
+import { HeroSection } from "@/components/(home)/heroSection";
 import type { Metadata } from "next";
+import Script from "next/script";
+
+const siteUrl = process.env.NEXT_PUBLIC_SITE_URL || "http://localhost:3000";
 
 export const metadata: Metadata = {
-  alternates: { canonical: "/" },
+  title: "Nexy - Modern Python Web Framework",
+  description: "Build fast, secure, and scalable web applications with Nexy. A modern Python framework built on FastAPI for exceptional performance and developer experience.",
+  keywords: [
+    "Nexy framework",
+    "Python web development",
+    "FastAPI framework",
+    "Modern web applications",
+    "High performance Python",
+    "Web framework",
+    "API development",
+  ],
+  openGraph: {
+    title: "Nexy - Modern Python Web Framework",
+    description: "Build fast, secure, and scalable web applications with Nexy. A modern Python framework built on FastAPI for exceptional performance and developer experience.",
+    type: "website",
+    url: siteUrl,
+  },
+  twitter: {
+    title: "Nexy - Modern Python Web Framework",
+    description: "Build fast, secure, and scalable web applications with Nexy. A modern Python framework built on FastAPI for exceptional performance and developer experience.",
+  },
+  alternates: {
+    canonical: siteUrl,
+  },
 };
-import { HeroSection } from "@/components/(home)/heroSection";
 
 const HomePage = () => {
      return (
         <>
+          {/* Structured Data - Homepage */}
+          <Script
+            id="ld-json-homepage"
+            type="application/ld+json"
+            strategy="beforeInteractive"
+            dangerouslySetInnerHTML={{
+              __html: JSON.stringify({
+                "@context": "https://schema.org",
+                "@type": "WebPage",
+                name: "Nexy - Modern Python Web Framework",
+                description: "Build fast, secure, and scalable web applications with Nexy. A modern Python framework built on FastAPI for exceptional performance and developer experience.",
+                url: siteUrl,
+                mainEntity: {
+                  "@type": "SoftwareApplication",
+                  name: "Nexy",
+                  description: "A modern Python web framework built on FastAPI",
+                  applicationCategory: "DeveloperApplication",
+                  operatingSystem: "Any",
+                  programmingLanguage: "Python",
+                  downloadUrl: "https://github.com/nexyframework/nexy",
+                },
+                breadcrumb: {
+                  "@type": "BreadcrumbList",
+                  itemListElement: [
+                    {
+                      "@type": "ListItem",
+                      position: 1,
+                      name: "Home",
+                      item: siteUrl,
+                    },
+                  ],
+                },
+              }),
+            }}
+          />
           <HeroSection/>
         </>
           
diff --git a/src/app/robots.ts b/src/app/robots.ts
index 731b5978..9a67a0d7 100644
--- a/src/app/robots.ts
+++ b/src/app/robots.ts
@@ -4,11 +4,32 @@ export default function robots(): MetadataRoute.Robots {
   const siteUrl = process.env.NEXT_PUBLIC_SITE_URL || "http://localhost:3000";
 
   return {
-    rules: {
-      userAgent: "*",
-      allow: "/",
-      disallow: ["/api/"],
-    },
+    rules: [
+      {
+        userAgent: "*",
+        allow: "/",
+        disallow: [
+          "/api/",
+          "/_next/",
+          "/admin/",
+          "/private/",
+          "/*.json$",
+          "/search?*",
+        ],
+      },
+      {
+        userAgent: "Googlebot",
+        allow: "/",
+        disallow: ["/api/", "/_next/"],
+        crawlDelay: 1,
+      },
+      {
+        userAgent: "Bingbot",
+        allow: "/",
+        disallow: ["/api/", "/_next/"],
+        crawlDelay: 1,
+      },
+    ],
     sitemap: `${siteUrl}/sitemap.xml`,
     host: siteUrl,
   };

From 32a8696c151ae1cba911ac3b2ad7596edb6de3c3 Mon Sep 17 00:00:00 2001
From: hopcy-forcy <hopcy.forcy@gmail.com>
Date: Sat, 9 Aug 2025 16:49:05 +0100
Subject: [PATCH 3/3] feat(layout): refactor viewport configuration and
 metadata structure

- Moved viewport settings to a separate export for better organization.
- Updated metadata to streamline layout configuration.
- Added themeColor settings back into the viewport configuration for improved responsiveness.
---
 src/app/layout.tsx | 23 ++++++++++++-----------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/src/app/layout.tsx b/src/app/layout.tsx
index a89cc213..ca4a0d1f 100644
--- a/src/app/layout.tsx
+++ b/src/app/layout.tsx
@@ -1,4 +1,4 @@
-import type { Metadata } from "next";
+import type { Metadata, Viewport } from "next";
 import Script from "next/script";
 import { Analytics } from "@vercel/analytics/react"
 import "./globals.css";
@@ -90,16 +90,6 @@ export const metadata: Metadata = {
     ],
     apple: "/nexy.svg",
   },
-  themeColor: [
-    { media: "(prefers-color-scheme: light)", color: "#0E201B" },
-    { media: "(prefers-color-scheme: dark)", color: "#0E201B" },
-  ],
-  viewport: {
-    width: "device-width",
-    initialScale: 1,
-    maximumScale: 5,
-    userScalable: true,
-  },
   verification: {
     google: process.env.GOOGLE_SITE_VERIFICATION,
   },
@@ -109,6 +99,17 @@ export const metadata: Metadata = {
   },
 };
 
+export const viewport: Viewport = {
+  width: "device-width",
+  initialScale: 1,
+  maximumScale: 5,
+  userScalable: true,
+  themeColor: [
+    { media: "(prefers-color-scheme: light)", color: "#0E201B" },
+    { media: "(prefers-color-scheme: dark)", color: "#0E201B" },
+  ],
+};
+
 export default function RootLayout({
   children,
 }: Readonly<{