Automated SEO

// ============================================
// Automated Sitemap Generator (app/sitemap.ts)
// ============================================

import { type MetadataRoute } from "next";
import { libraryVolumes } from "@/config/library-mapping";

const baseUrl = "https://cjs.codes";

/**
 * Automated Sitemap Generator
 * 
 * Generates a sitemap that stays in sync with the library structure.
 * Automatically includes:
 * - Static routes: /, /library
 * - Dynamic routes: All volume and chapter pages from library-mapping.ts
 * 
 * This ensures the sitemap is always up-to-date when new volumes or chapters are added.
 */
export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
  // Static routes
  const staticRoutes: MetadataRoute.Sitemap = [
    {
      url: baseUrl,
      lastModified: new Date(),
      changeFrequency: "weekly",
      priority: 1.0,
    },
    {
      url: `${baseUrl}/library`,
      lastModified: new Date(),
      changeFrequency: "weekly",
      priority: 0.9,
    },
  ];

  // Dynamic routes: Generate paths for all volumes and chapters
  // This pulls from the single source of truth: library-mapping.ts
  const dynamicRoutes: MetadataRoute.Sitemap = libraryVolumes.flatMap((volume) => {
    const volumeRoutes: MetadataRoute.Sitemap = [];

    // Volume index page: /library/[volume-id]
    volumeRoutes.push({
      url: `${baseUrl}/library/${volume.id}`,
      lastModified: new Date(),
      changeFrequency: "weekly",
      priority: 0.8,
    });

    // Chapter pages: /library/[volume-id]/[chapter-slug]
    const chapterRoutes: MetadataRoute.Sitemap = volume.chapters.map((chapter) => ({
      url: `${baseUrl}/library/${volume.id}/${chapter.slug}`,
      lastModified: new Date(),
      changeFrequency: "weekly",
      priority: 0.7,
    }));

    return [...volumeRoutes, ...chapterRoutes];
  });

  // Combine all routes
  return [...staticRoutes, ...dynamicRoutes];
}

// ============================================
// How It Works
// ============================================

// 1. Imports libraryVolumes from the single source of truth
// 2. Generates static routes (/, /library)
// 3. Uses flatMap to iterate over all volumes
// 4. For each volume, generates:
//    - Volume index page: /library/[volume-id]
//    - All chapter pages: /library/[volume-id]/[chapter-slug]
// 5. Returns combined array of all routes

// ============================================
// Adding New Routes
// ============================================

// To add a new route type (e.g., /blog/[slug]):
// 1. Update the sitemap.ts logic to include the new route segment
// 2. Never manually edit a static sitemap.xml file
// 3. Always extend the generator function, not create static entries

// Example: Adding blog posts
// const blogRoutes: MetadataRoute.Sitemap = blogPosts.map((post) => ({
//   url: `${baseUrl}/blog/${post.slug}`,
//   lastModified: post.updatedAt,
//   changeFrequency: "weekly",
//   priority: 0.6,
// }));
// return [...staticRoutes, ...dynamicRoutes, ...blogRoutes];

cjs.codes uses an automated sitemap generator (app/sitemap.ts) that pulls from library-mapping.ts to create a zero-maintenance SEO engine. The sitemap automatically includes all volumes and chapters from the library structure, ensuring it stays in sync without manual updates. The sitemap is available at /sitemap.xml and includes static routes (/, /library) and dynamic routes for all volume and chapter pages. This pattern uses a single source of truth for both content and SEO, eliminating the need for manual sitemap maintenance.