create-avalon 0.1.23 → 0.1.24

package/dist/cli.js

@@ -1156,13 +1156,15 @@ async function collectProjectConfig(initialName) {
   const pluginsResult = await Lt2({
     message: "Which plugins would you like to include? (use space to toggle, enter to confirm)",
     options: [
-      { value: "agent-optimization", label: "agent-optimization", hint: "LLM/AI optimization" },
+      { value: "seo", label: "seo", hint: "Auto-injects OG, Twitter cards, JSON-LD, canonical URLs" },
+      { value: "agent-optimization", label: "agent-optimization", hint: "LLM/AI optimization (llms.txt, markdown, sitemap)" },
       {
         value: "syntax-highlighting",
         label: "syntax-highlighting",
         hint: "Code block highlighting for MDX (rehype-highlight)"
       }
     ],
+    initialValues: ["seo"],
     required: false
   });
   if (Ct(pluginsResult)) {
@@ -1335,6 +1337,62 @@ const absoluteTimeout = setTimeout(() => {
 }, 240_000);
 `;
 }
+function generateRobotsTxt(sitemapUrl = "https://YOUR_DOMAIN/sitemap.xml") {
+  return `# robots.txt
+
+User-agent: *
+Allow: /
+
+# Sitemap
+Sitemap: ${sitemapUrl}
+
+# AI Crawlers — explicitly allowed
+User-agent: GPTBot
+Allow: /
+
+User-agent: ChatGPT-User
+Allow: /
+
+User-agent: Google-Extended
+Allow: /
+
+User-agent: PerplexityBot
+Allow: /
+
+User-agent: OAI-SearchBot
+Allow: /
+
+User-agent: Applebot-Extended
+Allow: /
+
+User-agent: Amazonbot
+Allow: /
+
+User-agent: ClaudeBot
+Allow: /
+
+User-agent: Bytespider
+Allow: /
+
+User-agent: cohere-ai
+Allow: /
+
+User-agent: Diffbot
+Allow: /
+
+User-agent: anthropic-ai
+Allow: /
+
+User-agent: Claude-Web
+Allow: /
+
+User-agent: CCBot
+Allow: /
+
+User-agent: AI2Bot
+Allow: /
+`;
+}
 
 // src/templates/favicon.ts
 var FAVICON_BASE64 = "AAABAAEAICAAAAEAIACoEAAAFgAAACgAAAAgAAAAQAAAAAEAIAAAAAAAABAAACMuAAAjLgAAAAAAAAAAAAAAAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8BAAD/AQAA/wEAAP8BAAD/AQAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wIBAP9DIQr/f0AT/4BAE/+AQBP/f0AT/34/E/9+PxL/fj8T/39AE/+BQBP/cjkR/yAQBf8GAwH/Wy4N/4hEFP+HRBT/h0QU/4dEFP+GQxT/hUMU/4VDE/+EQhP/hEIT/2QzD/8PCAL/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/KxYG/8BgHP/YbSD/12wg/9dsIP/XbCD/12wg/9dsIP/XbCD/12wg/9dsIP/YbSD/iEUU/1AoDP/OaB7/2Gwg/9dsIP/XbCD/12wg/9dsIP/XbCD/12wg/9dsIP/XbCD/1Gsf/18wDv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8+Hwn/z2ge/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9RqH//FYx3/jUcV/9BpH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Vax//r1ga/xgMBP8AAAD/AAAA/wAAAP8AAAD/AAAA/xEIAv+lUxj/1msf/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9VrH/+iURj/tlsb/9VrH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//XzAO/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/1UrDP/RaR//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//1Gof/8RiHf+ZTRb/0Wkf/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9VrH/+tVxn/FgsD/wAAAP8AAAD/AAAA/wAAAP8AAAD/EwoD/6lVGf/Wax//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//1Gsf/6FRGP+6XRv/1Wsf/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9BoH/9BIQr/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/Wi0N/9JqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Uax//wmId/51PF//Sah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Vax//ul4b/yQSBf8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8WCwP/rVcZ/9VrH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Uah//olEY/71fHP/Uax//02of/9NqH//Tah//02of/9NqH//Tah//02of/9FpH/9eLw7/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP9fLw7/02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9RrH//BYRz/oFEX/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Wax//l0wW/w0HAv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/xgMBP+wWRr/1Wsf/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH/+iUhj/wWEc/9RrH//Tah//02of/9NqH//Tah//1Gsf/8BhHP8xGQf/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/2QyD//Uah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//1Gsf/8BgHP+kUxj/02of/9NqH//Tah//02of/9NqH//Tah//ZzQP/wEAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/HA4E/7RaGv/Vax//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/6NSGP/EYh3/1Gof/9NqH//Tah//1msf/59QF/8RCQP/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/aTUP/9RrH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Uax//v2Ac/6hVGf/Uah//02of/9RrH//FYx3/ORwI/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8fDwT/t1wb/9VrH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Sah//pVMY/8dkHf/Uax//1Gsf/3E5EP8CAQD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP9uNxD/1Wsf/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//02of/9RrH/+8Xhz/m04X/81nHv+dTxf/FgsD/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/yIRBf+6Xhv/1Wsf/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Tah//1Gsf/79gHP8yGQf/MxoI/xcMA/8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/3Q6Ef/Vax//02of/9NqH//Tah//02of/9NqH//Tah//02of/9NqH//Uax//dDoR/wMBAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/JhMG/71fHP/Uax//02of/9NqH//Tah//02of/9NqH//Tah//1msf/6dUGP8XDAP/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8BAQD/eT0S/9ZrH//Tah//02of/9NqH//Tah//02of/9RqH//IZB3/QCAJ/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8qFQb/wGEc/9RrH//Tah//02of/9NqH//Tah//1Gsf/3c8Ev8DAgH/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wIBAP9+PxP/1msf/9NqH//Tah//02of/9ZrH/+nVBn/GAwE/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/y4XB//DYh3/1Gsf/9NqH//Uax//xWMd/zweCf8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AwIA/4NCE//Wax//02of/9NqH/9rNhD/AgEA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/MhkH/8VjHf/XbCD/mk4X/xAIAv8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8FAgH/iUUU/8BhHP8vGAf/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8yGQf/TygM/wEAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wEBAP8CAQD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=";
@@ -1351,16 +1409,21 @@ function generateRootLayout(config) {
   } else {
     imports.push(`import '../styles/main.css';`);
   }
+  const safeName = config.projectName.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/`/g, "\\`").replace(/\$\{/g, "\\${");
   return `${imports.join(`
 `)}
 
-export default async function RootLayout({ children }: Readonly<LayoutProps>) {
+export default async function RootLayout({ children, frontmatter }: Readonly<LayoutProps>) {
+  const title = frontmatter?.title ?? '${safeName}';
+  const description = frontmatter?.description ?? '';
+
   return (
     <html lang="en">
       <head>
         <meta charset="UTF-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <title>${config.projectName}</title>
+        <title>{title}</title>
+        {description && <meta name="description" content={description} />}
         <link rel="icon" href="/favicon.ico" />
       </head>
       <body style={{ margin: 0 }}>
@@ -1371,10 +1434,10 @@ export default async function RootLayout({ children }: Readonly<LayoutProps>) {
 }
 `;
 }
-function generateHomeLayout(config) {
+function generateMainLayout(config) {
   return `import type { LayoutProps } from '@useavalon/avalon';
 
-export default async function HomeLayout({ children }: Readonly<LayoutProps>) {
+export default async function MainLayout({ children }: Readonly<LayoutProps>) {
   return <>{children}</>;
 }
 `;
@@ -1401,9 +1464,9 @@ var INTEGRATION_PACKAGES = {
   qwik: "@useavalon/qwik"
 };
 var BASE_DIRS = [
-  "app/modules/home/pages",
-  "app/modules/home/components",
-  "app/modules/home/layouts",
+  "app/modules/main/pages",
+  "app/modules/main/components",
+  "app/modules/main/layouts",
   "app/shared/layouts",
   "app/shared/components",
   "app/shared/styles",
@@ -1421,6 +1484,9 @@ function generatePackageJson(config) {
   for (const integration of config.integrations) {
     dependencies[INTEGRATION_PACKAGES[integration]] = "latest";
   }
+  if (config.plugins.includes("seo")) {
+    dependencies["@useavalon/seo"] = "latest";
+  }
   if (config.plugins.includes("agent-optimization")) {
     dependencies["@useavalon/agent-optimization"] = "latest";
   }
@@ -1470,7 +1536,7 @@ function generatePackageJson(config) {
 }
 
 // src/templates/pages.ts
-function generateHomePage(config) {
+function generateMainPage(config) {
   return `export const metadata = {
   title: 'Avalon — Islands Architecture',
   description: 'A multi-framework islands architecture project powered by Avalon.',
@@ -1508,7 +1574,7 @@ export default async function HomePage() {
       <div style={{ position: 'relative', zIndex: 1, marginTop: '4rem', display: 'flex', flexDirection: 'column', alignItems: 'center', gap: '0.75rem' }}>
         <p style={{ fontSize: '0.75rem', color: '#64748b', letterSpacing: '0.1em', textTransform: 'uppercase' }}>Get started</p>
         <code style={{ display: 'block', padding: '0.6rem 1.2rem', borderRadius: '6px', background: 'rgba(255,255,255,0.04)', border: '1px solid rgba(255,255,255,0.08)', color: '#a5b4fc', fontSize: '0.85rem', fontFamily: 'ui-monospace, monospace' }}>
-          Edit app/modules/home/pages/index.tsx
+          Edit app/modules/main/pages/index.tsx
         </code>
       </div>
 
@@ -1523,6 +1589,24 @@ export default async function HomePage() {
 }
 `;
 }
+function generate404Page() {
+  return `export const metadata = {
+  title: '404 - Page Not Found',
+  description: 'The page you are looking for does not exist.',
+  robots: 'noindex, nofollow',
+};
+
+export default function NotFoundPage() {
+  return (
+    <div style={{ minHeight: '100vh', display: 'flex', flexDirection: 'column', alignItems: 'center', justifyContent: 'center', fontFamily: 'system-ui, -apple-system, sans-serif', textAlign: 'center', padding: '2rem' }}>
+      <h1 style={{ fontSize: '4rem', margin: '0 0 1rem' }}>404</h1>
+      <p style={{ fontSize: '1.25rem', color: '#64748b', margin: '0 0 2rem' }}>Page not found</p>
+      <a href="/" style={{ color: '#6366f1', textDecoration: 'none', fontWeight: 500 }}>Go Home</a>
+    </div>
+  );
+}
+`;
+}
 
 // src/templates/post-build.ts
 function generatePostBuildMjs() {
@@ -1558,8 +1642,8 @@ function generateStylingFiles(config) {
     case "css-modules":
       files.set("app/shared/styles/tokens.css", generateTokensCss());
       files.set("app/shared/layouts/_layout.module.css", generateLayoutModuleCss());
-      files.set("app/modules/home/pages/index.module.css", generatePageModuleCss());
-      files.set("app/modules/home/layouts/_layout.module.css", generateLayoutModuleCss());
+      files.set("app/modules/main/pages/index.module.css", generatePageModuleCss());
+      files.set("app/modules/main/layouts/_layout.module.css", generateLayoutModuleCss());
       break;
     case "tailwind":
       files.set("tailwind.config.js", generateTailwindConfig());
@@ -1819,20 +1903,37 @@ function generateViteConfig(config) {
   if (needsTailwind) {
     imports.push(`import tailwindcss from '@tailwindcss/vite';`);
   }
+  const hasSeo = config.plugins.includes("seo");
+  if (hasSeo) {
+    imports.push(`import { seo } from '@useavalon/seo';`);
+  }
   const hasAgentOptimization = config.plugins.includes("agent-optimization");
   if (hasAgentOptimization) {
     imports.push(`import { agentOptimization } from '@useavalon/agent-optimization';`);
   }
   const integrationsList = config.integrations.map((i) => `'${i}'`).join(", ");
   const pluginEntries = [];
+  if (hasSeo) {
+    pluginEntries.push(`    seo({
+      siteUrl: 'http://localhost:3000',
+      siteName: '${config.projectName.replace(/'/g, "\\'")}',
+      defaultDescription: 'Built with Avalon',
+      defaultOgImage: {
+        url: '/og-image.png',
+        width: 1200,
+        height: 630,
+      },
+      breadcrumbs: true,
+      speakable: true,
+    }),`);
+  }
   if (hasAgentOptimization) {
     pluginEntries.push(`    agentOptimization({
       sitemap: { siteUrl: 'http://localhost:3000' },
       markdown: true,
-      structuredData: true,
       llms: {
         siteUrl: 'http://localhost:3000',
-        siteName: 'My Avalon App',
+        siteName: '${config.projectName.replace(/'/g, "\\'")}',
         siteDescription: 'Built with Avalon',
         sections: { 'Pages': ['/'] },
       },
@@ -1955,8 +2056,9 @@ async function scaffoldProject(config, targetDir) {
   await writeFile(join(targetDir, "tsconfig.json"), generateTsConfig());
   await writeFile(join(targetDir, "vite.config.ts"), generateViteConfig(config));
   await writeFile(join(targetDir, "app/shared/layouts/_layout.tsx"), generateRootLayout(config));
-  await writeFile(join(targetDir, "app/modules/home/layouts/_layout.tsx"), generateHomeLayout(config));
-  await writeFile(join(targetDir, "app/modules/home/pages/index.tsx"), generateHomePage(config));
+  await writeFile(join(targetDir, "app/modules/main/layouts/_layout.tsx"), generateMainLayout(config));
+  await writeFile(join(targetDir, "app/modules/main/pages/index.tsx"), generateMainPage(config));
+  await writeFile(join(targetDir, "app/modules/main/pages/404.tsx"), generate404Page());
   await writeFile(join(targetDir, "middleware/01.logger.ts"), generateSampleMiddleware(config));
   await writeFile(join(targetDir, "routes/api/hello.ts"), generateHelloRoute(config));
   if (config.middleware === "hono") {
@@ -1970,6 +2072,7 @@ async function scaffoldProject(config, targetDir) {
     await writeFile(join(targetDir, filePath), content);
   }
   await writeFile(join(targetDir, "public/favicon.ico"), getFaviconBuffer());
+  await writeFile(join(targetDir, "public/robots.txt"), generateRobotsTxt());
   await writeFile(join(targetDir, "server/env.d.ts"), `/// <reference types="nitro" />
 `);
   await writeFile(join(targetDir, "app/env.d.ts"), generateEnvDts(config.integrations));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "create-avalon",
-	"version": "0.1.23",
+	"version": "0.1.24",
 	"description": "Scaffold a new Avalon project with multi-framework islands architecture",
 	"license": "MIT",
 	"type": "module",