@hutusi/amytis 1.9.0 → 1.11.0

package/src/app/books/[slug]/page.tsx

@@ -6,6 +6,8 @@ import CoverImage from '@/components/CoverImage';
 import MarkdownRenderer from '@/components/MarkdownRenderer';
 import Link from 'next/link';
 import { t, resolveLocale } from '@/lib/i18n';
+import { buildBookJsonLd, serializeJsonLd } from '@/lib/json-ld';
+import { getBookUrl } from '@/lib/urls';
 
 export async function generateStaticParams() {
   const books = getAllBooks();
@@ -58,8 +60,19 @@ export default async function BookLandingPage({ params }: { params: Promise<{ sl
 
   const firstChapter = book.chapters.length > 0 ? book.chapters[0] : null;
 
+  const siteUrl = siteConfig.baseUrl.replace(/\/+$/, '');
+  const jsonLd = buildBookJsonLd({
+    book,
+    bookUrl: `${siteUrl}${getBookUrl(slug)}`,
+    siteTitle: resolveLocale(siteConfig.title),
+    siteUrl,
+    defaultOgImage: siteConfig.ogImage,
+  });
+
   return (
-    <div className="layout-main">
+    <>
+      <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: serializeJsonLd(jsonLd) }} />
+      <div className="layout-main">
       <header className="mb-16">
         {/* Cover image */}
         {book.coverImage && (
@@ -170,6 +183,7 @@ export default async function BookLandingPage({ params }: { params: Promise<{ sl
           <MarkdownRenderer content={book.content} slug={`books/${book.slug}`} />
         </section>
       )}
-    </div>
+      </div>
+    </>
   );
 }

package/src/app/books/page.tsx

@@ -1,15 +1,19 @@
 import { getAllBooks } from '@/lib/markdown';
+import { getBookUrl } from '@/lib/urls';
 import Link from 'next/link';
 import { siteConfig } from '../../../site.config';
 import { Metadata } from 'next';
 import CoverImage from '@/components/CoverImage';
-import { t, resolveLocale } from '@/lib/i18n';
+import { t, resolveLocale, tWith } from '@/lib/i18n';
 import PageHeader from '@/components/PageHeader';
 
-export const metadata: Metadata = {
-  title: `${t('books')} | ${resolveLocale(siteConfig.title)}`,
-  description: 'Structured long-form books and guides.',
-};
+export async function generateMetadata(): Promise<Metadata> {
+  const books = getAllBooks();
+  return {
+    title: `${t('books')} | ${resolveLocale(siteConfig.title)}`,
+    description: books.length === 1 ? t('books_subtitle_one') : tWith('books_subtitle', { count: books.length }),
+  };
+}
 
 export default function BooksPage() {
   const books = getAllBooks();
@@ -18,15 +22,15 @@ export default function BooksPage() {
     <div className="layout-main">
       <PageHeader
         titleKey="books"
-        subtitleKey="series_subtitle"
-        subtitleOneKey="series_subtitle_one"
+        subtitleKey="books_subtitle"
+        subtitleOneKey="books_subtitle_one"
         count={books.length}
         subtitleParams={{ count: books.length }}
       />
 
       <div className="grid grid-cols-1 md:grid-cols-2 gap-8">
         {books.map(book => (
-          <Link key={book.slug} href={`/books/${book.slug}`} className="group block no-underline">
+          <Link key={book.slug} href={getBookUrl(book.slug)} className="group block no-underline">
             <div className="card-base h-full group flex flex-col p-0 overflow-hidden">
               <div className="relative h-48 w-full overflow-hidden bg-muted/10">
                 <CoverImage

package/src/app/feed.atom/route.ts

@@ -0,0 +1,62 @@
+import { siteConfig } from '../../../site.config';
+import { resolveLocale } from '@/lib/i18n';
+import { getFeedItems } from '@/lib/feed-utils';
+
+export const dynamic = 'force-static';
+
+const escapeXml = (v: string) =>
+  v.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+   .replace(/"/g, '&quot;').replace(/'/g, '&apos;');
+
+const escapeCdata = (v: string) => v.replace(/]]>/g, ']]]]><![CDATA[>');
+
+export async function GET() {
+  const { format, content: contentMode } = siteConfig.feed;
+  if (format === 'rss') {
+    return new Response('Not Found', { status: 404 });
+  }
+
+  const baseUrl = siteConfig.baseUrl.replace(/\/+$/, '');
+  const items = getFeedItems();
+  const useFullContent = contentMode === 'full';
+  const feedUpdated = items[0]?.date.toISOString() ?? new Date().toISOString();
+
+  const entriesXml = items
+    .map((item) => {
+      const contentXml = useFullContent
+        ? `<content type="html"><![CDATA[${escapeCdata(item.content)}]]></content>\n    <summary><![CDATA[${escapeCdata(item.excerpt)}]]></summary>`
+        : `<summary><![CDATA[${escapeCdata(item.excerpt)}]]></summary>`;
+      const authorsXml = item.authors?.map((a) => `<author><name>${escapeXml(a)}</name></author>`).join('') ?? '';
+      const categoriesXml = item.tags.map((tag) => `<category term="${escapeXml(tag)}" />`).join('');
+      return `
+  <entry>
+    <title><![CDATA[${escapeCdata(item.title)}]]></title>
+    <link href="${escapeXml(item.url)}" />
+    <id>${escapeXml(item.url)}</id>
+    <published>${item.date.toISOString()}</published>
+    <updated>${item.date.toISOString()}</updated>
+    ${contentXml}
+    ${authorsXml}
+    ${categoriesXml}
+  </entry>`;
+    })
+    .join('');
+
+  const atomXml = `<?xml version="1.0" encoding="UTF-8" ?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+  <title><![CDATA[${escapeCdata(resolveLocale(siteConfig.title))}]]></title>
+  <link href="${escapeXml(baseUrl)}" />
+  <link href="${escapeXml(baseUrl)}/feed.atom" rel="self" type="application/atom+xml" />
+  <id>${escapeXml(baseUrl)}/feed.atom</id>
+  <updated>${feedUpdated}</updated>
+  <subtitle><![CDATA[${escapeCdata(resolveLocale(siteConfig.description))}]]></subtitle>
+${entriesXml}
+</feed>`;
+
+  return new Response(atomXml, {
+    headers: {
+      'Content-Type': 'application/atom+xml; charset=utf-8',
+      'Cache-Control': 'public, max-age=3600',
+    },
+  });
+}

package/src/app/feed.xml/route.ts

@@ -1,44 +1,69 @@
-import { getAllPosts } from '@/lib/markdown';
 import { siteConfig } from '../../../site.config';
 import { resolveLocale } from '@/lib/i18n';
+import { getFeedItems } from '@/lib/feed-utils';
 
 export const dynamic = 'force-static';
 
+const escapeXml = (v: string) =>
+  v.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+   .replace(/"/g, '&quot;').replace(/'/g, '&apos;');
+
+const escapeCdata = (v: string) => v.replace(/]]>/g, ']]]]><![CDATA[>');
+
 export async function GET() {
-  const posts = getAllPosts();
-  const baseUrl = siteConfig.baseUrl;
+  const { format, content: contentMode } = siteConfig.feed;
+  if (format === 'atom') {
+    return new Response('Not Found', { status: 404 });
+  }
+
+  const baseUrl = siteConfig.baseUrl.replace(/\/+$/, '');
+  const items = getFeedItems();
+  const useFullContent = contentMode === 'full';
+  const contentNs = useFullContent ? ' xmlns:content="http://purl.org/rss/modules/content/"' : '';
+  const siteTitle = resolveLocale(siteConfig.title);
+  const lastBuildDate = items[0]?.date.toUTCString() ?? new Date().toUTCString();
+
+  const imageXml = siteConfig.ogImage
+    ? `\n    <image>\n      <url>${escapeXml(baseUrl + siteConfig.ogImage)}</url>\n      <title>${escapeXml(siteTitle)}</title>\n      <link>${escapeXml(baseUrl)}</link>\n    </image>`
+    : '';
 
-  const rssItemsXml = posts
-    .map((post) => {
-      const url = `${baseUrl}/posts/${post.slug}`;
+  const rssItemsXml = items
+    .map((item) => {
+      const fullContentXml = useFullContent
+        ? `\n          <content:encoded><![CDATA[${escapeCdata(item.content)}]]></content:encoded>`
+        : '';
+      const authorsXml = item.authors?.length
+        ? item.authors.map((a) => `\n          <dc:creator><![CDATA[${escapeCdata(a)}]]></dc:creator>`).join('')
+        : '';
       return `
         <item>
-          <title><![CDATA[${post.title}]]></title>
-          <link>${url}</link>
-          <guid>${url}</guid>
-          <pubDate>${new Date(post.date).toUTCString()}</pubDate>
-          <description><![CDATA[${post.excerpt}]]></description>
-          ${post.tags ? post.tags.map(tag => `<category>${tag}</category>`).join('') : ''}
+          <title><![CDATA[${escapeCdata(item.title)}]]></title>
+          <link>${escapeXml(item.url)}</link>
+          <guid isPermaLink="true">${escapeXml(item.url)}</guid>
+          <pubDate>${item.date.toUTCString()}</pubDate>
+          <description><![CDATA[${escapeCdata(item.excerpt)}]]></description>${fullContentXml}${authorsXml}
+          ${item.tags.map((tag) => `<category><![CDATA[${escapeCdata(tag)}]]></category>`).join('')}
         </item>`;
     })
     .join('');
 
   const rssXml = `<?xml version="1.0" encoding="UTF-8" ?>
-<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/"${contentNs}>
   <channel>
-    <title><![CDATA[${resolveLocale(siteConfig.title)}]]></title>
-    <link>${baseUrl}</link>
-    <description><![CDATA[${resolveLocale(siteConfig.description)}]]></description>
-    <language>en</language>
-    <lastBuildDate>${new Date().toUTCString()}</lastBuildDate>
-    <atom:link href="${baseUrl}/feed.xml" rel="self" type="application/rss+xml" />
+    <title><![CDATA[${escapeCdata(siteTitle)}]]></title>
+    <link>${escapeXml(baseUrl)}</link>
+    <description><![CDATA[${escapeCdata(resolveLocale(siteConfig.description))}]]></description>
+    <language>${siteConfig.i18n.defaultLocale}</language>
+    <lastBuildDate>${lastBuildDate}</lastBuildDate>
+    <atom:link href="${escapeXml(baseUrl)}/feed.xml" rel="self" type="application/rss+xml" />${imageXml}
     ${rssItemsXml}
   </channel>
 </rss>`;
 
   return new Response(rssXml, {
     headers: {
-      'Content-Type': 'application/xml',
+      'Content-Type': 'application/rss+xml; charset=utf-8',
+      'Cache-Control': 'public, max-age=3600',
     },
   });
 }

package/src/app/flows/[year]/[month]/[day]/page.tsx

@@ -4,6 +4,7 @@ import { Metadata } from 'next';
 import { notFound } from 'next/navigation';
 import { t, resolveLocale } from '@/lib/i18n';
 import FlowCalendarSidebar from '@/components/FlowCalendarSidebar';
+import Tag from '@/components/Tag';
 import MarkdownRenderer from '@/components/MarkdownRenderer';
 import Backlinks from '@/components/Backlinks';
 import ShareBar from '@/components/ShareBar';
@@ -85,11 +86,18 @@ export default async function FlowPage({ params }: { params: Promise<{ year: str
           {/* Header */}
           <header className="mb-8">
             <time className="text-base font-mono text-accent" data-pagefind-meta="date[content]">{flow.date}</time>
+            {flow.tags.length > 0 && (
+              <div className="mt-3 flex flex-wrap gap-2">
+                {flow.tags.map(tag => (
+                  <Tag key={tag} tag={tag} variant="compact" />
+                ))}
+              </div>
+            )}
           </header>
 
           {/* Content */}
           <div className="prose prose-lg dark:prose-invert max-w-none">
-            <MarkdownRenderer content={flow.content} slugRegistry={slugRegistry} />
+            <MarkdownRenderer content={flow.content} slug={`flows/${year}/${month}/${day}`} slugRegistry={slugRegistry} />
           </div>
 
           <Backlinks backlinks={backlinks} />

package/src/app/flows/[year]/page.tsx

@@ -84,7 +84,7 @@ export default async function FlowsYearPage({ params }: { params: Promise<{ year
         flows={flows}
         entryDates={entryDates}
         tags={tags}
-        currentDate={`${year}-01-01`}
+        currentDate={flows[0]?.date}
         breadcrumb={breadcrumb}
       />
     </div>

package/src/app/flows/page/[page]/page.tsx

@@ -44,12 +44,14 @@ export default async function FlowsPaginatedPage({ params }: { params: Promise<{
   const start = (page - 1) * PAGE_SIZE;
   const end = start + PAGE_SIZE;
   const flows = allFlows.slice(start, end);
+  const allFlowItems = allFlows.map(({ slug, date, title, excerpt, tags }) => ({ slug, date, title, excerpt, tags }));
 
   return (
     <div className="layout-main">
       <FlowHubTabs subtitle={tWith('page_of_total', { page, total: totalPages })} />
       <FlowContent
         flows={flows}
+        allFlows={allFlowItems}
         entryDates={entryDates}
         tags={tags}
         pagination={{ currentPage: page, totalPages, basePath: '/flows' }}

package/src/app/flows/page.tsx

@@ -20,12 +20,16 @@ export default function FlowsPage() {
   const flows = allFlows.slice(0, PAGE_SIZE);
   const entryDates = allFlows.map(f => f.date);
   const tags = getFlowTags();
+  const allFlowItems = totalPages > 1
+    ? allFlows.map(({ slug, date, title, excerpt, tags }) => ({ slug, date, title, excerpt, tags }))
+    : undefined;
 
   return (
     <div className="layout-main">
       <FlowHubTabs subtitle={tWith('flow_subtitle', { count: allFlows.length })} />
       <FlowContent
         flows={flows}
+        allFlows={allFlowItems}
         entryDates={entryDates}
         tags={tags}
         pagination={totalPages > 1 ? { currentPage: 1, totalPages, basePath: '/flows' } : undefined}

package/src/app/globals.css

@@ -1,7 +1,12 @@
 @import "tailwindcss";
-@import "katex/dist/katex.min.css";
 @plugin "@tailwindcss/typography";
 
+html {
+  scroll-behavior: smooth;
+  scroll-padding-top: 4rem; /* offset for fixed navbar (h-16 = 64px) */
+  overflow-x: hidden;
+}
+
 :root {
   /* Warm/Paper-like background for "Elegant" feel */
   --background: #fafaf9; /* Stone 50 */
@@ -14,7 +19,7 @@
 }
 
 .dark {
-  --background: #1c1917; /* Stone 900 */
+  --background: #292524; /* Stone 800 */
   --foreground: #f5f5f4; /* Stone 100 */
   --heading: #fafaf9; /* Stone 50 */
   --accent: #34d399; /* Emerald 400 */
@@ -436,6 +441,7 @@ pre[class*="language-"] {
 body {
   background-color: var(--background);
   color: var(--foreground);
+  overflow-x: hidden;
   /* Font smoothing for elegance */
   -webkit-font-smoothing: antialiased;
   -moz-osx-font-smoothing: grayscale;
@@ -444,4 +450,4 @@ body {
 /* Ensure anchor links are not hidden behind the fixed navbar */
 [id] {
   scroll-margin-top: 5rem;
-}
+}

package/src/app/layout.tsx

@@ -10,6 +10,7 @@ import { LanguageProvider } from "@/components/LanguageProvider";
 import { getAllSeries, getAllBooks, getSeriesData } from "@/lib/markdown";
 import { resolveLocale } from "@/lib/i18n";
 import "./globals.css";
+import "katex/dist/katex.min.css";
 
 const inter = localFont({
   src: [
@@ -54,13 +55,33 @@ const siteTwitterHandle = (() => {
   return m ? `@${m[1]}` : undefined;
 })();
 
+// Build icon metadata with explicit MIME type so browsers correctly handle
+// all formats. Without this, .ico files served via the metadata API lack
+// type="image/x-icon" and may be ignored in favour of app/favicon.ico.
+const faviconSrc = siteConfig.logo?.favicon || "/icon.svg";
+const ext = faviconSrc.split('.').pop()?.toLowerCase();
+const faviconMeta =
+  ext === 'ico' ? [{ url: faviconSrc, type: 'image/x-icon', sizes: 'any' }] :
+  ext === 'png' ? [{ url: faviconSrc, type: 'image/png' }] :
+  ext === 'svg' ? [{ url: faviconSrc, type: 'image/svg+xml' }] :
+  faviconSrc;
+
+const feedAlternates = (() => {
+  const { format } = siteConfig.feed;
+  const types: Record<string, string> = {};
+  if (format === 'rss' || format === 'both') types['application/rss+xml'] = '/feed.xml';
+  if (format === 'atom' || format === 'both') types['application/atom+xml'] = '/feed.atom';
+  return Object.keys(types).length > 0 ? { types } : undefined;
+})();
+
 export const metadata: Metadata = {
   metadataBase: new URL(siteConfig.baseUrl),
   title: resolveLocale(siteConfig.title),
   description: resolveLocale(siteConfig.description),
   icons: {
-    icon: "/icon.svg",
+    icon: faviconMeta,
   },
+  ...(feedAlternates && { alternates: feedAlternates }),
   openGraph: {
     siteName: resolveLocale(siteConfig.title),
     locale: siteConfig.i18n.defaultLocale,

package/src/app/notes/[slug]/page.tsx

@@ -74,7 +74,7 @@ export default async function NotePage({ params }: { params: Promise<{ slug: str
             breadcrumb={breadcrumb}
           />
         )}
-        <article className="min-w-0 max-w-3xl mx-auto">
+        <article className="min-w-0 w-full max-w-3xl mx-auto overflow-x-hidden">
           <header className="mb-8 border-b border-muted/10 pb-8">
             {note.draft && (
               <div className="mb-4">
@@ -98,7 +98,7 @@ export default async function NotePage({ params }: { params: Promise<{ slug: str
             )}
           </header>
 
-          <MarkdownRenderer content={note.content} slug={note.slug} slugRegistry={slugRegistry} />
+          <MarkdownRenderer content={note.content} slug={`notes/${note.slug}`} slugRegistry={slugRegistry} />
 
           {/* Prev/Next navigation */}
           <nav aria-label="Note navigation" className="mt-12 pt-12 border-t border-muted/20 grid grid-cols-2 gap-4">
@@ -126,4 +126,3 @@ export default async function NotePage({ params }: { params: Promise<{ slug: str
     </div>
   );
 }
-

package/src/app/page.tsx

@@ -1,4 +1,5 @@
-import { getAllPosts, getFeaturedSeries, getSeriesData, getFeaturedPosts, getFeaturedBooks, getRecentFlows } from '@/lib/markdown';
+import type { ReactNode } from 'react';
+import { getAllPosts, getAllFlows, getAllSeries, getFeaturedSeries, getSeriesData, getFeaturedPosts, getAllBooks, getFeaturedBooks, getRecentFlows } from '@/lib/markdown';
 import { siteConfig } from '../../site.config';
 import Hero from '@/components/Hero';
 import CuratedSeriesSection, { SeriesItem } from '@/components/CuratedSeriesSection';
@@ -7,7 +8,8 @@ import SelectedBooksSection, { BookItem } from '@/components/SelectedBooksSectio
 import LatestWritingSection from '@/components/LatestWritingSection';
 import RecentNotesSection, { RecentNoteItem } from '@/components/RecentNotesSection';
 import { Metadata } from 'next';
-import { resolveLocale } from '@/lib/i18n';
+import { t, resolveLocale } from '@/lib/i18n';
+import { buildWebsiteJsonLd, serializeJsonLd } from '@/lib/json-ld';
 
 export const metadata: Metadata = {
   title: resolveLocale(siteConfig.title),
@@ -21,7 +23,7 @@ export const metadata: Metadata = {
     images: [{ url: siteConfig.ogImage, width: 1200, height: 630 }],
   },
   twitter: {
-    card: 'summary',
+    card: 'summary_large_image',
     title: resolveLocale(siteConfig.title),
     description: resolveLocale(siteConfig.description),
   },
@@ -70,7 +72,7 @@ export default function Home() {
         return {
           name,
           title: seriesData?.title || name,
-          excerpt: seriesData?.excerpt || "A growing collection of related thoughts.",
+          excerpt: seriesData?.excerpt || t('series_default_excerpt'),
           coverImage: seriesData?.coverImage,
           url: `/series/${slug}`,
           postCount: seriesPosts.length,
@@ -103,14 +105,25 @@ export default function Home() {
     ? featuredPosts.map(p => ({
         slug: p.slug,
         title: p.title,
+        subtitle: p.subtitle,
         excerpt: p.excerpt,
         date: p.date,
         category: p.category,
         readingTime: p.readingTime,
         coverImage: p.coverImage,
+        series: p.series,
+        pinned: p.pinned,
       }))
     : [];
 
+  // Stats for hero navigation chips
+  const heroPostCount = has('hero') && features?.posts?.enabled !== false
+    ? (needsPosts ? allPosts : getAllPosts()).length
+    : undefined;
+  const heroSeriesCount = has('hero') && features?.series?.enabled !== false ? Object.keys(getAllSeries()).length : undefined;
+  const heroBookCount = has('hero') && features?.books?.enabled !== false ? getAllBooks().length : undefined;
+  const heroFlowCount = has('hero') && features?.flow?.enabled !== false ? getAllFlows().length : undefined;
+
   const renderSection = (section: HomepageSection) => {
     switch (section.id) {
       case 'featured-series':
@@ -130,7 +143,6 @@ export default function Home() {
             key="featured-books"
             books={bookItems}
             maxItems={section.maxItems ?? 4}
-            scrollThreshold={section.scrollThreshold ?? 2}
           />
         );
       case 'featured-posts':
@@ -140,7 +152,6 @@ export default function Home() {
             key="featured-posts"
             allFeatured={featuredItems}
             maxItems={section.maxItems ?? 4}
-            scrollThreshold={section.scrollThreshold ?? 1}
           />
         );
       case 'latest-posts':
@@ -154,19 +165,86 @@ export default function Home() {
     }
   };
 
+  // Build content sections, pairing latest-posts + recent-flows into a two-column layout
+  const sectionsForContent = sections.filter(s => s.id !== 'hero');
+  const latestIdx = sectionsForContent.findIndex(s => s.id === 'latest-posts');
+  const flowsIdx = sectionsForContent.findIndex(s => s.id === 'recent-flows');
+  const pairLatestFlows = latestIdx >= 0 && flowsIdx >= 0;
+
+  // Show a divider after the two-column section when series follows it
+  const divideBeforeSeries = pairLatestFlows
+    && has('featured-series')
+    && features?.series?.enabled !== false
+    && seriesItems.length > 0;
+
+  const renderList: ReactNode[] = [];
+  const skippedIds = new Set<string>();
+
+  for (const section of sectionsForContent) {
+    if (skippedIds.has(section.id)) continue;
+
+    if (pairLatestFlows && (section.id === 'latest-posts' || section.id === 'recent-flows')) {
+      skippedIds.add(section.id === 'latest-posts' ? 'recent-flows' : 'latest-posts');
+      const showLatest = features?.posts?.enabled !== false;
+      const showFlows = features?.flow?.enabled !== false && recentNoteItems.length > 0;
+      if (showLatest || showFlows) {
+        renderList.push(
+          <div key="latest-flows-combined" className={`grid grid-cols-1 lg:grid-cols-12 gap-12 lg:gap-16 ${divideBeforeSeries ? 'mb-16' : 'mb-24'}`}>
+            {showLatest && (
+              <div className="lg:col-span-7">
+                <LatestWritingSection posts={posts} totalCount={allPosts.length} />
+              </div>
+            )}
+            {showFlows && (
+              <div className="lg:col-span-5">
+                <RecentNotesSection notes={recentNoteItems} />
+              </div>
+            )}
+          </div>
+        );
+        if (divideBeforeSeries) {
+          renderList.push(
+            <div key="series-divider" className="border-t border-muted/10 mb-16" />
+          );
+        }
+      }
+    } else {
+      renderList.push(renderSection(section));
+    }
+  }
+
+  const websiteJsonLd = buildWebsiteJsonLd({
+    siteTitle: resolveLocale(siteConfig.title),
+    siteUrl: siteConfig.baseUrl,
+    description: resolveLocale(siteConfig.description),
+  });
+
   return (
+    <>
+    <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: serializeJsonLd(websiteJsonLd) }} />
     <div>
       {has('hero') && (
         <Hero
           tagline={siteConfig.hero.tagline}
           title={siteConfig.hero.title}
           subtitle={siteConfig.hero.subtitle}
+          postCount={heroPostCount}
+          seriesCount={heroSeriesCount}
+          bookCount={heroBookCount}
+          flowCount={heroFlowCount}
+          featureNames={{
+            flow:   features?.flow?.name,
+            posts:  features?.posts?.name,
+            series: features?.series?.name,
+            books:  features?.books?.name,
+          }}
         />
       )}
 
-      <div className="layout-main pt-0 md:pt-0">
-        {sections.filter(s => s.id !== 'hero').map(renderSection)}
+      <div className="layout-main pt-0 md:pt-0 [&>*:last-child]:mb-0">
+        {renderList}
       </div>
     </div>
+    </>
   );
 }

package/src/app/posts/[slug]/page.tsx

@@ -5,6 +5,8 @@ import SimpleLayout from '@/layouts/SimpleLayout';
 import { Metadata } from 'next';
 import { siteConfig } from '../../../../site.config';
 import { resolveLocale } from '@/lib/i18n';
+import { getPostsBasePath, getPostUrl } from '@/lib/urls';
+import { buildPostJsonLd, serializeJsonLd, resolveImageUrl } from '@/lib/json-ld';
 
 function safeDecodeParam(param: string): string {
   try {
@@ -29,9 +31,20 @@ function resolvePostFromParam(rawSlug: string) {
  * This ensures fast page loads and SEO optimization.
  */
 export async function generateStaticParams() {
+  if (getPostsBasePath() !== 'posts') return [{ slug: '_' }]; // Route disabled; custom path handles this
   const posts = getAllPosts();
   if (posts.length === 0) return [{ slug: '_' }];
-  return posts.map((post) => ({ slug: post.slug }));
+  // Work around Next dev static-param checks for percent-encoded Unicode paths
+  // under `output: "export"` by including encoded variants only in development.
+  // Production export keeps raw segment values.
+  const slugs = new Set<string>();
+  for (const post of posts) {
+    slugs.add(post.slug);
+    if (process.env.NODE_ENV !== 'production') {
+      slugs.add(encodeURIComponent(post.slug));
+    }
+  }
+  return Array.from(slugs).map((slug) => ({ slug }));
 }
 
 export const dynamicParams = false;
@@ -46,9 +59,8 @@ export async function generateMetadata({ params }: { params: Promise<{ slug: str
     };
   }
 
-  const ogImage = post.coverImage && !post.coverImage.startsWith('text:') && !post.coverImage.startsWith('./')
-    ? post.coverImage
-    : siteConfig.ogImage;
+  const siteUrl = siteConfig.baseUrl.replace(/\/+$/, '');
+  const ogImage = resolveImageUrl(post.coverImage, siteConfig.ogImage, siteUrl);
 
   return {
     title: `${post.title} | ${resolveLocale(siteConfig.title)}`,
@@ -94,8 +106,18 @@ export default async function PostPage({
   // Determine layout based on frontmatter
   const layout = post.layout || 'post';
 
+  const siteUrl = siteConfig.baseUrl.replace(/\/+$/, '');
+  const jsonLd = buildPostJsonLd({
+    post,
+    postUrl: `${siteUrl}${getPostUrl(post)}`,
+    siteTitle: resolveLocale(siteConfig.title),
+    siteUrl,
+    defaultOgImage: siteConfig.ogImage,
+  });
+  const jsonLdScript = <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: serializeJsonLd(jsonLd) }} />;
+
   if (layout === 'simple') {
-    return <SimpleLayout post={post} />;
+    return <>{jsonLdScript}<SimpleLayout post={post} /></>;
   }
 
   const relatedPosts = getRelatedPosts(slug);
@@ -111,6 +133,10 @@ export default async function PostPage({
     seriesTitle = seriesData?.title;
   }
 
-  // Default to standard post layout
-  return <PostLayout post={post} relatedPosts={relatedPosts} seriesPosts={seriesPosts} seriesTitle={seriesTitle} prevPost={prev} nextPost={next} backlinks={backlinks} slugRegistry={slugRegistry} />;
+  return (
+    <>
+      {jsonLdScript}
+      <PostLayout post={post} relatedPosts={relatedPosts} seriesPosts={seriesPosts} seriesTitle={seriesTitle} prevPost={prev} nextPost={next} backlinks={backlinks} slugRegistry={slugRegistry} />
+    </>
+  );
 }