rothzerg 0.1.4 → 0.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rothzerg",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Plugin-style CLI engine for scaffolding and upgrading projects from config-driven, inheritable templates",
   "type": "module",
   "bin": {

package/templates/{website-mobile/overrides → website-blog}/App.tsx

@@ -12,7 +12,6 @@ import { BlogPostPage } from "./pages/blog/post";
 import { BlogTagPage } from "./pages/blog/tag";
 import { BlogCategoryPage } from "./pages/blog/category";
 import { BlogAuthorPage } from "./pages/blog/author";
-import { DeepLinkLayout } from "./components/DeepLinkLayout";
 import { getI18nInstance, isValidLanguage } from "./i18n/config";
 import { DEFAULT_LANGUAGE, SITE_CONFIG } from "./config";
 
@@ -42,7 +41,6 @@ export function App() {
         <Route path="/:lang/terms" element={<LanguageWrapper><TermsPage /></LanguageWrapper>} />
         <Route path="/:lang/privacy" element={<LanguageWrapper><PrivacyPage /></LanguageWrapper>} />
         <Route path="/:lang/support" element={<LanguageWrapper><SupportPage /></LanguageWrapper>} />
-        {/* Blog pages */}
         <Route path="/:lang/blog" element={<LanguageWrapper><BlogIndexPage /></LanguageWrapper>} />
         <Route path="/:lang/blog/page/:page" element={<LanguageWrapper><BlogIndexPage /></LanguageWrapper>} />
         <Route path="/:lang/blog/tag/:slug" element={<LanguageWrapper><BlogTagPage /></LanguageWrapper>} />
@@ -52,9 +50,6 @@ export function App() {
         <Route path="/:lang/blog/author/:slug" element={<LanguageWrapper><BlogAuthorPage /></LanguageWrapper>} />
         <Route path="/:lang/blog/author/:slug/page/:page" element={<LanguageWrapper><BlogAuthorPage /></LanguageWrapper>} />
         <Route path="/:lang/blog/:slug" element={<LanguageWrapper><BlogPostPage /></LanguageWrapper>} />
-        {/* Deep link pages */}
-        <Route path="/dl/:type/:id" element={<DeepLinkLayout />} />
-        <Route path="/dl/:type" element={<DeepLinkLayout />} />
         <Route path="*" element={<LanguageWrapper><NotFoundPage /></LanguageWrapper>} />
       </Routes>
     </>

package/templates/{_base-website → website-blog}/client.tsx

@@ -4,8 +4,6 @@ import { BrowserRouter } from "react-router-dom";
 import { App } from "./App.tsx";
 import { InitialDataProvider } from "./InitialDataContext.tsx";
 
-// Hydrate the app on the client side
-// @ts-ignore
 const rootElement = document.getElementById("root");
 if (rootElement) {
   // @ts-ignore

package/templates/website-blog/{overrides/config.ts → config.ts}

@@ -2,28 +2,18 @@ import { fetchAPI } from "../../utils";
 
 export const API_BASE_URL = "https://api.{{domain}}";
 
-export const SUPPORTED_LANGUAGES = [
-  "en", "de", "fr", "it", "ja", "ko", "tr", "zh", "es", "pt",
-  "hi", "ar", "ru", "pl", "nl", "id", "vi", "th", "sv",
-] as const;
+export const SUPPORTED_LANGUAGES = ["en"] as const;
 
 export type Language = typeof SUPPORTED_LANGUAGES[number];
 export const DEFAULT_LANGUAGE: Language = "en";
 export const APP_ADS_TXT = '';
 
 export const LANGUAGE_LOCALES: Record<Language, string> = {
-  en: "en_US", de: "de_DE", fr: "fr_FR", it: "it_IT", ja: "ja_JP",
-  ko: "ko_KR", tr: "tr_TR", zh: "zh_CN", es: "es_ES", pt: "pt_BR",
-  hi: "hi_IN", ar: "ar_SA", ru: "ru_RU", pl: "pl_PL", nl: "nl_NL",
-  id: "id_ID", vi: "vi_VN", th: "th_TH", sv: "sv_SE",
+  en: "en_US",
 };
 
 export const LANGUAGE_NAMES: Record<Language, string> = {
-  en: "English", de: "Deutsch", fr: "Français", it: "Italiano",
-  ja: "日本語", ko: "한국어", tr: "Türkçe", zh: "中文", es: "Español",
-  pt: "Português", hi: "हिन्दी", ar: "العربية", ru: "Русский",
-  pl: "Polski", nl: "Nederlands", id: "Indonesia", vi: "Tiếng Việt",
-  th: "ไทย", sv: "Svenska",
+  en: "English",
 };
 
 export const SITE_CONFIG = {

package/templates/website-blog/data/blog/authors.json

@@ -0,0 +1,18 @@
+[
+  {
+    "slug": "site-author",
+    "name": "{{siteName}}",
+    "avatar": "",
+    "bio": {
+      "en": "The team behind {{siteName}}."
+    },
+    "seo": {
+      "pageTitle": {
+        "en": "{{siteName}} — Author"
+      },
+      "metaDescription": {
+        "en": "Posts by {{siteName}}."
+      }
+    }
+  }
+]

package/templates/website-blog/data/blog/categories.json

@@ -0,0 +1,19 @@
+[
+  {
+    "slug": "general",
+    "name": {
+      "en": "General"
+    },
+    "description": {
+      "en": "General posts and announcements."
+    },
+    "seo": {
+      "pageTitle": {
+        "en": "General Posts"
+      },
+      "metaDescription": {
+        "en": "General posts and announcements from {{siteName}}."
+      }
+    }
+  }
+]

package/templates/website-blog/data/blog/posts.json

@@ -0,0 +1,22 @@
+[
+  {
+    "slug": "hello-world",
+    "title": {
+      "en": "Hello World — Getting Started with {{siteName}}"
+    },
+    "excerpt": {
+      "en": "Welcome to {{siteName}}! This is your first blog post. Edit this file to add your own content and start sharing your ideas with the world."
+    },
+    "content": {
+      "en": "<p>Welcome to <strong>{{siteName}}</strong>! This is your first blog post.</p>\n\n<h2>Getting Started</h2>\n<p>To add new posts, edit the <code>data/blog/posts.json</code> file in your website directory. Each post has a slug, title, excerpt, content, and optional metadata like author, category, and tags.</p>\n\n<h2>Next Steps</h2>\n<ul>\n  <li>Update <code>config.ts</code> with your site details</li>\n  <li>Add more posts to <code>data/blog/posts.json</code></li>\n  <li>Add authors, categories, and tags to their respective JSON files</li>\n  <li>Customize the styles in the <code>styles/</code> directory</li>\n  <li>Add your translations in <code>i18n/sections/</code></li>\n</ul>\n\n<p>Happy blogging!</p>"
+    },
+    "coverImage": "https://picsum.photos/seed/hello-world/1200/630",
+    "authorSlug": "site-author",
+    "categorySlug": "general",
+    "tagSlugs": ["getting-started"],
+    "publishedAt": "{{builtIn:date}}T10:00:00Z",
+    "updatedAt": "{{builtIn:date}}T10:00:00Z",
+    "status": "published",
+    "readingTimeMinutes": 2
+  }
+]

package/templates/website-blog/data/blog/tags.json

@@ -0,0 +1,16 @@
+[
+  {
+    "slug": "getting-started",
+    "name": {
+      "en": "Getting Started"
+    },
+    "seo": {
+      "pageTitle": {
+        "en": "Getting Started Posts"
+      },
+      "metaDescription": {
+        "en": "Getting started guides and introductory posts from {{siteName}}."
+      }
+    }
+  }
+]

package/templates/website-blog/i18n/config.ts

@@ -0,0 +1,43 @@
+import i18n, { createInstance } from "i18next";
+import { initReactI18next } from "react-i18next";
+import { translations } from "./translations";
+import { DEFAULT_LANGUAGE, SUPPORTED_LANGUAGES } from "../config";
+
+export type SupportedLanguage = (typeof SUPPORTED_LANGUAGES)[number];
+
+let clientInstance: typeof i18n | null = null;
+
+export function getI18nInstance(language: SupportedLanguage = DEFAULT_LANGUAGE) {
+  // @ts-ignore
+  const isClient = typeof globalThis !== "undefined" && typeof globalThis.window !== "undefined";
+
+  if (isClient) {
+    if (!clientInstance) {
+      clientInstance = i18n.createInstance();
+      clientInstance.use(initReactI18next).init({
+        resources: translations,
+        lng: language,
+        fallbackLng: DEFAULT_LANGUAGE,
+        interpolation: { escapeValue: false },
+        react: { useSuspense: false },
+        showSupportNotice: false,
+      });
+    }
+    return clientInstance;
+  }
+
+  const serverInstance = createInstance();
+  serverInstance.use(initReactI18next).init({
+    resources: translations,
+    lng: language,
+    fallbackLng: DEFAULT_LANGUAGE,
+    interpolation: { escapeValue: false },
+    react: { useSuspense: false },
+    showSupportNotice: false,
+  });
+  return serverInstance;
+}
+
+export function isValidLanguage(lang: string): lang is SupportedLanguage {
+  return SUPPORTED_LANGUAGES.includes(lang as SupportedLanguage);
+}

package/templates/website-blog/i18n/sections/common/_index.ts

@@ -0,0 +1,5 @@
+import { commonEN } from "./en";
+
+export const commonTranslations: Record<string, any> = {
+  en: commonEN,
+};

package/templates/website-blog/i18n/sections/common/en.ts

@@ -0,0 +1,24 @@
+export const commonEN: Record<string, any> = {
+  meta: {
+    homeTitle: "Home",
+    homeDescription: "A blog by {{siteName}} — articles, tutorials, and insights.",
+    termsTitle: "Terms of Service",
+    termsDescription: "Read the {{siteName}} Terms of Service.",
+    privacyTitle: "Privacy Policy",
+    privacyDescription: "Learn how {{siteName}} collects and protects your information.",
+    supportTitle: "Support",
+    supportDescription: "Get help with {{siteName}}.",
+  },
+  nav: {
+    home: "Home",
+    blog: "Blog",
+    support: "Support",
+  },
+  footer: {
+    tagline: "Articles and insights",
+    legal: "Legal",
+    privacyPolicy: "Privacy Policy",
+    termsOfService: "Terms of Service",
+    copyright: "All rights reserved.",
+  },
+};

package/templates/website-blog/i18n/sections/home/_index.ts

@@ -0,0 +1,5 @@
+import { homeEN } from "./en";
+
+export const homeTranslations: Record<string, any> = {
+  en: homeEN,
+};

package/templates/website-blog/i18n/sections/home/en.ts

@@ -0,0 +1,7 @@
+export const homeEN: Record<string, any> = {
+  hero: {
+    title: "Hello from {{siteName}}",
+    subtitle: "A blog with articles, tutorials, and insights.",
+    cta: "Read the Blog",
+  },
+};

package/templates/website-blog/i18n/translations.ts

@@ -0,0 +1,18 @@
+// {{siteName}} translations
+import { commonTranslations } from "./sections/common/_index";
+import { homeTranslations } from "./sections/home/_index";
+
+export const translationData: Record<string, any> = {};
+
+const languages = Object.keys(commonTranslations);
+
+for (const lang of languages) {
+  translationData[lang] = {
+    ...commonTranslations[lang],
+    ...homeTranslations[lang],
+  };
+}
+
+export const translations: Record<string, { translation: any }> = Object.fromEntries(
+  Object.entries(translationData).map(([lang, data]) => [lang, { translation: data }])
+);

package/templates/{_base-website → website-blog}/index.ts

@@ -10,8 +10,7 @@ import { InitialDataProvider } from "./InitialDataContext.tsx";
 import { getRobotsTxt } from "../../utils/get-robots.ts";
 import { escapeHtml } from "../../utils/html-utils.ts";
 import { generateHreflangTags, generateSitemap } from "../../utils/seo-utils.ts";
-import { matchDeepLinkSegment } from "../../utils/routing-utils.ts";
-import { renderDeepLinkPage, renderNotFound } from "../../utils/render-utils.ts";
+import { renderNotFound } from "../../utils/render-utils.ts";
 import {
   getBlogPostsWithDetails,
   getBlogPostWithDetails,
@@ -45,7 +44,6 @@ async function getBlogSidebar(lang: string) {
 
 const SITE_DIR = "{{domain}}";
 
-// Generate CSS and JS bundles at startup
 const cssInputPath = new URL("./styles/_app.css", import.meta.url).pathname;
 const outputDir = new URL("./public", import.meta.url).pathname;
 
@@ -82,7 +80,7 @@ function getPageMeta(pathname: string): {
     description = t.meta.supportDescription;
   } else if (page === "blog") {
     title = "Blog";
-    description = `Articles, tutorials, and insights on building modern web applications from ${SITE_CONFIG.name}.`;
+    description = `Articles and insights from ${SITE_CONFIG.name}.`;
   }
 
   return {
@@ -106,7 +104,7 @@ function buildBaseHtml(
 ): string {
   const locale = LANGUAGE_LOCALES[lang] || "en_US";
   const canonicalUrl = `${SITE_CONFIG.url}${pathname}`;
-  const isRTL = lang === "ar";
+  const isRTL = false;
   const safeTitle = escapeHtml(title);
   const safeDesc = escapeHtml(description);
   const imageUrl = ogImage || `${SITE_CONFIG.url}/static/images/og-image.png`;
@@ -124,7 +122,6 @@ function buildBaseHtml(
     <meta name="theme-color" content="${SITE_CONFIG.themeColor}">
     <link rel="canonical" href="${canonicalUrl}">
 ${generateHreflangTags(pathname, SUPPORTED_LANGUAGES, SITE_CONFIG.url, DEFAULT_LANGUAGE)}
-    <!-- Open Graph -->
     <meta property="og:type" content="${ogType}">
     <meta property="og:title" content="${safeTitle}">
     <meta property="og:description" content="${safeDesc}">
@@ -132,17 +129,13 @@ ${generateHreflangTags(pathname, SUPPORTED_LANGUAGES, SITE_CONFIG.url, DEFAULT_L
     <meta property="og:site_name" content="${SITE_CONFIG.name}">
     <meta property="og:locale" content="${locale}">
     <meta property="og:image" content="${imageUrl}">
-    <!-- Twitter Card -->
     <meta name="twitter:card" content="summary_large_image">
     <meta name="twitter:title" content="${safeTitle}">
     <meta name="twitter:description" content="${safeDesc}">
     <meta name="twitter:site" content="${SITE_CONFIG.twitterHandle}">
     <meta name="twitter:image" content="${imageUrl}">
-    <!-- App Links -->
-    <meta name="apple-itunes-app" content="app-id=${SITE_CONFIG.iosAppId}">
 ${extraHead}
-${SITE_CONFIG.googleAnalyticsId ? `    <!-- Google Analytics -->
-    <script async src="https://www.googletagmanager.com/gtag/js?id=${SITE_CONFIG.googleAnalyticsId}"></script>
+${SITE_CONFIG.googleAnalyticsId ? `    <script async src="https://www.googletagmanager.com/gtag/js?id=${SITE_CONFIG.googleAnalyticsId}"></script>
     <script>window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}gtag('js',new Date());gtag('config','${SITE_CONFIG.googleAnalyticsId}');</script>` : ""}
     <script>(function(){var t=localStorage.getItem('theme')||(window.matchMedia('(prefers-color-scheme: dark)').matches?'dark':'light');document.documentElement.setAttribute('data-theme',t);})();</script>
     <style>
@@ -161,7 +154,6 @@ ${SITE_CONFIG.googleAnalyticsId ? `    <!-- Google Analytics -->
 </html>`;
 }
 
-
 export async function handleRequest(hostname: string, pathname: string = "/"): Promise<Response> {
   if (pathname === "/") {
     return new Response(null, {
@@ -170,9 +162,9 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
     });
   }
 
-  // ── Blog API routes (/api/blog/:lang/...) ────────────────────────────────
+  // Blog API routes
   if (pathname.startsWith("/api/blog/")) {
-    const parts = pathname.split("/").filter(Boolean); // ["api","blog",lang,resource?,id?]
+    const parts = pathname.split("/").filter(Boolean);
     const blogLang = parts[2];
     const resource = parts[3];
     const id = parts[4];
@@ -190,23 +182,19 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
       const posts = await getBlogPostsWithDetails(SITE_DIR, lang);
       return new Response(JSON.stringify(posts), { headers: jsonHeaders });
     }
-
     if (resource === "posts" && id) {
       const post = await getBlogPostWithDetails(SITE_DIR, lang, id);
       if (!post) return notFoundJson;
       return new Response(JSON.stringify(post), { headers: jsonHeaders });
     }
-
     if (resource === "categories") {
       const categories = await getBlogCategories(SITE_DIR, lang);
       return new Response(JSON.stringify(categories), { headers: jsonHeaders });
     }
-
     if (resource === "tags") {
       const tags = await getBlogTags(SITE_DIR, lang);
       return new Response(JSON.stringify(tags), { headers: jsonHeaders });
     }
-
     if (resource === "authors" && id) {
       const author = await getBlogAuthor(SITE_DIR, lang, id);
       if (!author) return notFoundJson;
@@ -216,7 +204,7 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
     return notFoundJson;
   }
 
-  // ── Blog SSR pages (/:lang/blog and /:lang/blog/:slug) ───────────────────
+  // Blog SSR pages
   const pathParts = pathname.split("/").filter(Boolean);
   if (pathParts[1] === "blog" && isValidLanguage(pathParts[0])) {
     const pageLang = pathParts[0] as Language;
@@ -230,7 +218,6 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
       return { items, pagination: { page: safePage, totalPages, total: allItems.length, baseUrl: "" } };
     }
 
-    // ── Tag / Category / Author filter pages ────────────────────────────────
     if (slug === "tag" && pathParts[3]) {
       const tagSlug = pathParts[3];
       const pageNum = pathParts[4] === "page" && pathParts[5] ? parseInt(pathParts[5], 10) || 1 : 1;
@@ -240,8 +227,6 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
       ]);
       const { items: posts, pagination } = paginate(allPosts, pageNum);
       pagination.baseUrl = `/${pageLang}/blog/tag/${tagSlug}`;
-      const pageTitle = `${tag?.name ?? tagSlug} — Tag | ${SITE_CONFIG.name}`;
-      const pageDesc = `Posts tagged "${tag?.name ?? tagSlug}" on ${SITE_CONFIG.name}.`;
       const data = { posts, tag, sidebar, pagination };
       const bodyHtml = renderToString(
         React.createElement(StaticRouter, { location: pathname },
@@ -251,7 +236,7 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
         )
       );
       return new Response(
-        buildBaseHtml(pathname, pageLang, pageTitle, pageDesc, "website", bodyHtml, "", undefined, data),
+        buildBaseHtml(pathname, pageLang, `${tag?.name ?? tagSlug} — Tag | ${SITE_CONFIG.name}`, `Posts tagged "${tag?.name ?? tagSlug}".`, "website", bodyHtml, "", undefined, data),
         { headers: { "Content-Type": "text/html; charset=utf-8" } }
       );
     }
@@ -265,8 +250,6 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
       ]);
       const { items: posts, pagination } = paginate(allPosts, pageNum);
       pagination.baseUrl = `/${pageLang}/blog/category/${categorySlug}`;
-      const pageTitle = `${category?.name ?? categorySlug} — Category | ${SITE_CONFIG.name}`;
-      const pageDesc = category?.description ?? `Posts in category "${category?.name ?? categorySlug}" on ${SITE_CONFIG.name}.`;
       const data = { posts, category, sidebar, pagination };
       const bodyHtml = renderToString(
         React.createElement(StaticRouter, { location: pathname },
@@ -276,7 +259,7 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
         )
       );
       return new Response(
-        buildBaseHtml(pathname, pageLang, pageTitle, pageDesc, "website", bodyHtml, "", undefined, data),
+        buildBaseHtml(pathname, pageLang, `${category?.name ?? categorySlug} — Category | ${SITE_CONFIG.name}`, category?.description ?? `Posts in ${category?.name ?? categorySlug}.`, "website", bodyHtml, "", undefined, data),
         { headers: { "Content-Type": "text/html; charset=utf-8" } }
       );
     }
@@ -290,8 +273,6 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
       ]);
       const { items: posts, pagination } = paginate(allPosts, pageNum);
       pagination.baseUrl = `/${pageLang}/blog/author/${authorSlug}`;
-      const pageTitle = `${author?.name ?? authorSlug} — Author | ${SITE_CONFIG.name}`;
-      const pageDesc = author?.bio?.substring(0, 160) ?? `Posts by ${author?.name ?? authorSlug} on ${SITE_CONFIG.name}.`;
       const data = { posts, author, sidebar, pagination };
       const bodyHtml = renderToString(
         React.createElement(StaticRouter, { location: pathname },
@@ -301,12 +282,11 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
         )
       );
       return new Response(
-        buildBaseHtml(pathname, pageLang, pageTitle, pageDesc, "website", bodyHtml, "", undefined, data),
+        buildBaseHtml(pathname, pageLang, `${author?.name ?? authorSlug} — Author | ${SITE_CONFIG.name}`, author?.bio?.substring(0, 160) ?? `Posts by ${author?.name ?? authorSlug}.`, "website", bodyHtml, "", undefined, data),
         { headers: { "Content-Type": "text/html; charset=utf-8" } }
       );
     }
 
-    // ── Blog listing with optional page: /page/:page ─────────────────────
     if (slug === "page" && pathParts[3]) {
       const pageNum = parseInt(pathParts[3], 10) || 1;
       if (pageNum === 1) {
@@ -318,8 +298,6 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
       ]);
       const { items: posts, pagination } = paginate(allPosts, pageNum);
       pagination.baseUrl = `/${pageLang}/blog`;
-      const listTitle = `Blog — Page ${pageNum} | ${SITE_CONFIG.name}`;
-      const listDesc = `Articles, tutorials, and insights on building modern web applications from ${SITE_CONFIG.name}.`;
       const data = { posts, sidebar, pagination };
       const bodyHtml = renderToString(
         React.createElement(StaticRouter, { location: pathname },
@@ -329,13 +307,12 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
         )
       );
       return new Response(
-        buildBaseHtml(pathname, pageLang, listTitle, listDesc, "website", bodyHtml, "", undefined, data),
+        buildBaseHtml(pathname, pageLang, `Blog — Page ${pageNum} | ${SITE_CONFIG.name}`, `Articles from ${SITE_CONFIG.name}.`, "website", bodyHtml, "", undefined, data),
         { headers: { "Content-Type": "text/html; charset=utf-8" } }
       );
     }
 
     if (slug) {
-      // Single blog post page
       const [post, sidebar] = await Promise.all([
         getBlogPostWithDetails(SITE_DIR, pageLang, slug),
         getBlogSidebar(pageLang),
@@ -343,9 +320,6 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
       if (!post) {
         return renderNotFound(cssContent, clientName, SITE_CONFIG.name, StaticRouter, App);
       }
-
-      const postTitle = `${escapeHtml(post.title)} | ${SITE_CONFIG.name}`;
-      const postDesc = escapeHtml(post.excerpt.substring(0, 160));
       const jsonLd = JSON.stringify({
         "@context": "https://schema.org",
         "@type": "BlogPosting",
@@ -367,22 +341,19 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
           )
         )
       );
-
       return new Response(
-        buildBaseHtml(pathname, pageLang, postTitle, postDesc, "article", bodyHtml, extraHead, post.coverImage || undefined, data),
+        buildBaseHtml(pathname, pageLang, `${escapeHtml(post.title)} | ${SITE_CONFIG.name}`, escapeHtml(post.excerpt.substring(0, 160)), "article", bodyHtml, extraHead, post.coverImage || undefined, data),
         { headers: { "Content-Type": "text/html; charset=utf-8" } }
       );
     }
 
-    // Blog listing page (page 1)
+    // Blog listing (page 1)
     const [allPosts, sidebar] = await Promise.all([
       getBlogPostsWithDetails(SITE_DIR, pageLang),
       getBlogSidebar(pageLang),
     ]);
     const { items: posts, pagination } = paginate(allPosts, 1);
     pagination.baseUrl = `/${pageLang}/blog`;
-    const listTitle = `Blog | ${SITE_CONFIG.name}`;
-    const listDesc = `Articles, tutorials, and insights on building modern web applications from ${SITE_CONFIG.name}.`;
     const data = { posts, sidebar, pagination };
     const bodyHtml = renderToString(
       React.createElement(StaticRouter, { location: pathname },
@@ -391,27 +362,41 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
         )
       )
     );
+    return new Response(
+      buildBaseHtml(pathname, pageLang, `Blog | ${SITE_CONFIG.name}`, `Articles and insights from ${SITE_CONFIG.name}.`, "website", bodyHtml, "", undefined, data),
+      { headers: { "Content-Type": "text/html; charset=utf-8" } }
+    );
+  }
 
+  // Home page: inject recent posts
+  const pathParts2 = pathname.split("/").filter(Boolean);
+  if (pathParts2.length <= 1 && isValidLanguage(pathParts2[0])) {
+    const pageLang = pathParts2[0] as Language;
+    const allPosts = await getBlogPostsWithDetails(SITE_DIR, pageLang);
+    const posts = allPosts.slice(0, 3);
+    const data = { posts };
+    const { lang, title, description, ogType } = getPageMeta(pathname);
+    const bodyHtml = renderToString(
+      React.createElement(StaticRouter, { location: pathname },
+        React.createElement(InitialDataProvider, { data },
+          React.createElement(App)
+        )
+      )
+    );
     return new Response(
-      buildBaseHtml(pathname, pageLang, listTitle, listDesc, "website", bodyHtml, "", undefined, data),
+      buildBaseHtml(pathname, lang, title, description, ogType, bodyHtml, "", undefined, data),
       { headers: { "Content-Type": "text/html; charset=utf-8" } }
     );
   }
 
   if (pathname === "/app-ads.txt") {
-    return new Response(APP_ADS_TXT, {
-      headers: {
-        "Content-Type": "text/plain",
-      },
-    });
+    return new Response(APP_ADS_TXT, { headers: { "Content-Type": "text/plain" } });
   }
 
-  // robots.txt
   if (pathname === "/robots.txt") {
-    return getRobotsTxt(SITE_CONFIG.url, hostname.includes("dev."))
+    return getRobotsTxt(SITE_CONFIG.url, hostname.includes("dev."));
   }
 
-  // sitemap.xml
   if (pathname === "/sitemap.xml") {
     const [posts, categories, tags, authors] = await Promise.all([
       getBlogPostsWithDetails(SITE_DIR, DEFAULT_LANGUAGE),
@@ -419,7 +404,6 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
       getBlogTags(SITE_DIR, DEFAULT_LANGUAGE),
       getBlogAuthors(SITE_DIR, DEFAULT_LANGUAGE),
     ]);
-
     const pages = [
       { path: "", priority: "1.0", changefreq: "weekly" },
       { path: "/blog", priority: "0.9", changefreq: "daily" },
@@ -427,32 +411,20 @@ export async function handleRequest(hostname: string, pathname: string = "/"): P
       ...categories.map((c) => ({ path: `/blog/category/${c.slug}`, priority: "0.6", changefreq: "weekly" })),
       ...tags.map((t) => ({ path: `/blog/tag/${t.slug}`, priority: "0.5", changefreq: "weekly" })),
       ...authors.map((a) => ({ path: `/blog/author/${a.slug}`, priority: "0.6", changefreq: "weekly" })),
-      { path: "/support", priority: "0.8", changefreq: "monthly" },
+      { path: "/support", priority: "0.7", changefreq: "monthly" },
       { path: "/privacy", priority: "0.5", changefreq: "yearly" },
       { path: "/terms", priority: "0.5", changefreq: "yearly" },
     ];
-
-    const sitemap = generateSitemap(
-      pages,
-      SUPPORTED_LANGUAGES,
-      SITE_CONFIG.url,
-      DEFAULT_LANGUAGE
-    );
-
+    const sitemap = generateSitemap(pages, SUPPORTED_LANGUAGES, SITE_CONFIG.url, DEFAULT_LANGUAGE);
     return new Response(sitemap, {
-      headers: {
-        "Content-Type": "application/xml; charset=utf-8",
-        "Cache-Control": "public, max-age=86400",
-      },
+      headers: { "Content-Type": "application/xml; charset=utf-8", "Cache-Control": "public, max-age=86400" },
     });
   }
 
   const { lang, title, description, ogType } = getPageMeta(pathname);
-
   const bodyHtml = renderToString(
     React.createElement(StaticRouter, { location: pathname }, React.createElement(App))
   );
-
   return new Response(
     buildBaseHtml(pathname, lang, title, description, ogType, bodyHtml),
     { headers: { "Content-Type": "text/html; charset=utf-8" } }

package/templates/website-blog/pages/404.tsx

@@ -0,0 +1,31 @@
+import React from "react";
+import { Link, useParams } from "react-router-dom";
+import { SITE_CONFIG } from "../config";
+
+export function NotFoundPage() {
+  const { lang } = useParams<{ lang: string }>();
+  const l = lang || "en";
+
+  return (
+    <div style={{ minHeight: "100vh", display: "flex", flexDirection: "column", backgroundColor: "var(--color-bg)", color: "var(--color-text)" }}>
+      <header style={{ padding: "1rem 2rem", borderBottom: "1px solid var(--color-border)", display: "flex", alignItems: "center", justifyContent: "space-between" }}>
+        <a href={`/${l}/`} style={{ fontWeight: 700, fontSize: "1.1rem", textDecoration: "none", color: "var(--color-text)" }}>{SITE_CONFIG.name}</a>
+        <nav style={{ display: "flex", gap: "1.5rem", fontSize: "0.9rem" }}>
+          <Link to={`/${l}/blog`} style={{ textDecoration: "none", color: "var(--color-text-muted)" }}>Blog</Link>
+          <Link to={`/${l}/support`} style={{ textDecoration: "none", color: "var(--color-text-muted)" }}>Support</Link>
+        </nav>
+      </header>
+      <main style={{ flex: 1, display: "flex", flexDirection: "column", alignItems: "center", justifyContent: "center", padding: "4rem 2rem", textAlign: "center" }}>
+        <p style={{ fontSize: "5rem", fontWeight: 800, margin: "0 0 0.5rem", background: "linear-gradient(to right, var(--color-primary), var(--color-secondary))", WebkitBackgroundClip: "text", WebkitTextFillColor: "transparent" }}>404</p>
+        <h1 style={{ fontSize: "1.75rem", fontWeight: 700, margin: "0 0 1rem" }}>Page not found</h1>
+        <p style={{ color: "var(--color-text-muted)", margin: "0 0 2rem" }}>The page you're looking for doesn't exist or has been moved.</p>
+        <Link to={`/${l}/`} style={{ padding: "0.75rem 1.5rem", background: "var(--color-primary)", color: "#fff", borderRadius: "0.5rem", textDecoration: "none", fontWeight: 600 }}>
+          Go Home
+        </Link>
+      </main>
+      <footer style={{ padding: "1.5rem 2rem", borderTop: "1px solid var(--color-border)", textAlign: "center", fontSize: "0.875rem", color: "var(--color-text-muted)" }}>
+        <p style={{ margin: 0 }}>&copy; {new Date().getFullYear()} {SITE_CONFIG.name}. All rights reserved.</p>
+      </footer>
+    </div>
+  );
+}