Add SEO, sitemap/robots and bump image to v1.1.0

Add site SEO utilities and metadata and wire them into the app. Introduce docs/src/lib/seo.ts and apply Metadata to layout, home and docs pages (openGraph, twitter, canonical/alternates, robots). Add robots.ts and sitemap.ts routes (sitemap built from source pages). Also update quick-start/installation examples and homepage: hhftechnology/crowdsec-manager image bumped from 1.0.0 to 1.1.0 and the displayed stable release updated to 1.1.0.

Author: hhftechnology

docs/content/docs/installation.mdx

@@ -27,7 +27,7 @@ Use this minimum compose file:
 ```yaml
 services:
   crowdsec-manager:
-    image: hhftechnology/crowdsec-manager:1.0.0
+    image: hhftechnology/crowdsec-manager:1.1.0
     container_name: crowdsec-manager
     restart: unless-stopped
     expose:

docs/content/docs/quick-start.mdx

@@ -18,7 +18,7 @@ mkdir -p ./backups ./data
 ```yaml
 services:
   crowdsec-manager:
-    image: hhftechnology/crowdsec-manager:1.0.0
+    image: hhftechnology/crowdsec-manager:1.1.0
     container_name: crowdsec-manager
     restart: unless-stopped
     expose:

docs/src/app/(home)/page.tsx

@@ -1,8 +1,34 @@
 import Link from 'next/link';
+import type { Metadata } from 'next';
+import { getSiteUrl } from '@/lib/seo';
+
+const siteUrl = getSiteUrl();
+
+export const metadata: Metadata = {
+  title: 'Home',
+  description:
+    'CrowdSec Manager documentation home. Start with installation, quick start, features, and API references.',
+  alternates: {
+    canonical: '/',
+  },
+  openGraph: {
+    type: 'website',
+    url: siteUrl,
+    title: 'CrowdSec Manager Documentation',
+    description:
+      'Start here for CrowdSec Manager setup, configuration, and API documentation.',
+  },
+  twitter: {
+    card: 'summary_large_image',
+    title: 'CrowdSec Manager Documentation',
+    description:
+      'Start here for CrowdSec Manager setup, configuration, and API documentation.',
+  },
+};
 
 const quickInstall = `services:
   crowdsec-manager:
-    image: hhftechnology/crowdsec-manager:1.0.0
+    image: hhftechnology/crowdsec-manager:1.1.0
     container_name: crowdsec-manager
     restart: unless-stopped
     expose:
@@ -35,7 +61,7 @@ export default function HomePage() {
             Stable Release
           </p>
           <h1 className="mb-4 text-4xl font-extrabold tracking-tight text-foreground lg:text-6xl">
-            CrowdSec Manager 1.0.0
+            CrowdSec Manager 1.1.0
           </h1>
           <p className="mx-auto mb-8 max-w-3xl text-base text-muted-foreground lg:text-lg">
             Manage CrowdSec, Traefik integration, decisions, scenarios, logs, backups, and updates

docs/src/app/docs/[[...slug]]/page.tsx

@@ -9,6 +9,7 @@ import { notFound } from 'next/navigation';
 import { getMDXComponents } from '@/mdx-components';
 import type { Metadata } from 'next';
 import { createRelativeLink } from 'fumadocs-ui/mdx';
+import { getSiteUrl, siteMetadata } from '@/lib/seo';
 
 export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {
   const params = await props.params;
@@ -43,12 +44,41 @@ export async function generateMetadata(
   const params = await props.params;
   const page = source.getPage(params.slug);
   if (!page) notFound();
+  const siteUrl = getSiteUrl();
+  const pathname = page.slugs.length > 0 ? `/docs/${page.slugs.join('/')}` : '/docs';
+  const canonicalUrl = `${siteUrl}${pathname}`;
+  const ogImageUrl = `${siteUrl}${getPageImage(page).url}`;
 
   return {
     title: page.data.title,
     description: page.data.description,
+    alternates: {
+      canonical: pathname,
+    },
+    robots: {
+      index: true,
+      follow: true,
+    },
     openGraph: {
-      images: getPageImage(page).url,
+      type: 'article',
+      url: canonicalUrl,
+      siteName: siteMetadata.name,
+      title: page.data.title,
+      description: page.data.description,
+      images: [
+        {
+          url: ogImageUrl,
+          width: 1200,
+          height: 630,
+          alt: page.data.title,
+        },
+      ],
+    },
+    twitter: {
+      card: 'summary_large_image',
+      title: page.data.title,
+      description: page.data.description,
+      images: [ogImageUrl],
     },
   };
 }

docs/src/app/layout.tsx

@@ -1,13 +1,55 @@
 import { RootProvider } from 'fumadocs-ui/provider/next';
 import './global.css';
 import { Inter } from 'next/font/google';
+import type { Metadata } from 'next';
+import { getSiteUrl, siteMetadata } from '@/lib/seo';
 
 const inter = Inter({
   subsets: ['latin'],
 });
 
 import { type ReactNode } from 'react';
 
+const siteUrl = getSiteUrl();
+
+export const metadata: Metadata = {
+  metadataBase: new URL(siteUrl),
+  title: {
+    default: siteMetadata.title,
+    template: `%s | ${siteMetadata.name}`,
+  },
+  description: siteMetadata.description,
+  keywords: siteMetadata.keywords,
+  applicationName: siteMetadata.name,
+  alternates: {
+    canonical: '/',
+  },
+  robots: {
+    index: true,
+    follow: true,
+    googleBot: {
+      index: true,
+      follow: true,
+      'max-image-preview': 'large',
+      'max-snippet': -1,
+      'max-video-preview': -1,
+    },
+  },
+  openGraph: {
+    type: 'website',
+    locale: 'en_US',
+    url: siteUrl,
+    siteName: siteMetadata.name,
+    title: siteMetadata.title,
+    description: siteMetadata.description,
+  },
+  twitter: {
+    card: 'summary_large_image',
+    title: siteMetadata.title,
+    description: siteMetadata.description,
+  },
+};
+
 export default function Layout({ children }: { children: ReactNode }) {
   return (
     <html lang="en" className={inter.className} suppressHydrationWarning>

docs/src/app/robots.ts

@@ -0,0 +1,15 @@
+import type { MetadataRoute } from 'next';
+import { getSiteUrl } from '@/lib/seo';
+
+export default function robots(): MetadataRoute.Robots {
+  const siteUrl = getSiteUrl();
+
+  return {
+    rules: {
+      userAgent: '*',
+      allow: '/',
+    },
+    sitemap: `${siteUrl}/sitemap.xml`,
+    host: siteUrl,
+  };
+}

docs/src/app/sitemap.ts

@@ -0,0 +1,35 @@
+import type { MetadataRoute } from 'next';
+import { source } from '@/lib/source';
+import { getSiteUrl } from '@/lib/seo';
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const siteUrl = getSiteUrl();
+  const now = new Date();
+
+  const staticRoutes: MetadataRoute.Sitemap = [
+    {
+      url: siteUrl,
+      lastModified: now,
+      changeFrequency: 'weekly',
+      priority: 1,
+    },
+    {
+      url: `${siteUrl}/docs`,
+      lastModified: now,
+      changeFrequency: 'daily',
+      priority: 0.9,
+    },
+  ];
+
+  const docRoutes: MetadataRoute.Sitemap = source
+    .getPages()
+    .filter((page) => page.slugs.length > 0)
+    .map((page) => ({
+      url: `${siteUrl}/docs/${page.slugs.join('/')}`,
+      lastModified: now,
+      changeFrequency: 'weekly',
+      priority: page.slugs.length === 1 ? 0.85 : 0.75,
+    }));
+
+  return [...staticRoutes, ...docRoutes];
+}

docs/src/lib/seo.ts

@@ -0,0 +1,24 @@
+const fallbackSiteUrl = 'https://crowdsec-manager-docs.vercel.app';
+
+export function getSiteUrl(): string {
+  const envUrl = process.env.NEXT_PUBLIC_SITE_URL ?? process.env.SITE_URL;
+  if (!envUrl) return fallbackSiteUrl;
+
+  const withProtocol = envUrl.startsWith('http') ? envUrl : `https://${envUrl}`;
+  return withProtocol.replace(/\/+$/, '');
+}
+
+export const siteMetadata = {
+  name: 'CrowdSec Manager Docs',
+  title: 'CrowdSec Manager Documentation',
+  description:
+    'Official documentation for CrowdSec Manager: installation, configuration, API, and operational guides.',
+  keywords: [
+    'CrowdSec Manager',
+    'CrowdSec',
+    'Pangolin',
+    'Traefik',
+    'security dashboard',
+    'CrowdSec documentation',
+  ],
+};