create-audora-next 0.1.1

package/templates/base/src/app/llms-full.txt/route.ts

@@ -0,0 +1,97 @@
+import { SITE_CONFIG } from "@/config/site";
+import LLMS_DATA from "@/data/llms";
+
+export const dynamic = "force-static";
+
+export function GET() {
+  const content = `# ${SITE_CONFIG.name}
+
+> ${SITE_CONFIG.tagline}
+
+${SITE_CONFIG.description}
+
+## Quick Start
+
+\`\`\`bash
+${LLMS_DATA.quickStart}
+cd my-app
+bun install
+bun dev
+\`\`\`
+
+## Resources
+
+- Summary: ${SITE_CONFIG.url}/llms.txt
+- Sitemap: ${SITE_CONFIG.url}/sitemap.xml
+- Repository: ${LLMS_DATA.repository}
+
+## Tech Stack
+
+${LLMS_DATA.techStack.map((item) => `- ${item}`).join("\n")}
+
+## Features
+
+${LLMS_DATA.features.map((item) => `- ${item}`).join("\n")}
+
+## Folder Structure
+
+\`\`\`
+${LLMS_DATA.folderStructure}
+\`\`\`
+
+## Development Commands
+
+| Command | Description |
+|---------|-------------|
+| \`${LLMS_DATA.commands.dev}\` | Start development server |
+| \`${LLMS_DATA.commands.build}\` | Build for production |
+| \`${LLMS_DATA.commands.start}\` | Start production server |
+| \`${LLMS_DATA.commands.lint}\` | Lint code |
+| \`${LLMS_DATA.commands.format}\` | Format code |
+
+${LLMS_DATA.seoDetails}
+
+${LLMS_DATA.conventions}
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| \`NEXT_PUBLIC_SITE_URL\` | Base URL for sitemap, robots.txt, and Open Graph |
+
+## Key Files
+
+### src/data/site.ts
+Contains site configuration that powers SEO metadata:
+- name, url, ogImage
+- tagline, description, shortDescription
+- twitterHandle, keywords
+
+### src/lib/seo.ts
+SEO utility functions:
+- getMetadata() - Root layout metadata
+- getPageMetadata() - Per-page metadata
+- getViewport() - Viewport with theme colors
+- JSON-LD generators for structured data
+
+### src/app/layout.tsx
+Root layout with:
+- Metadata exports
+- Theme provider
+- Geist font configuration
+
+### src/components/theme-toggle.tsx
+Dark/light mode toggle component using next-themes.
+
+## License
+
+MIT
+`;
+
+  return new Response(content, {
+    headers: {
+      "Content-Type": "text/plain; charset=utf-8",
+      "Cache-Control": "public, max-age=3600, s-maxage=86400",
+    },
+  });
+}

package/templates/base/src/app/llms.txt/route.ts

@@ -0,0 +1,40 @@
+import { SITE_CONFIG } from "@/config/site";
+import LLMS_DATA from "@/data/llms";
+
+export const dynamic = "force-static";
+
+export function GET() {
+  const content = `# ${SITE_CONFIG.name}
+
+> ${SITE_CONFIG.tagline}
+
+${SITE_CONFIG.description}
+
+## Quick Start
+
+\`\`\`bash
+${LLMS_DATA.quickStart}
+\`\`\`
+
+## Resources
+
+- Full documentation: ${SITE_CONFIG.url}/llms-full.txt
+- Sitemap: ${SITE_CONFIG.url}/sitemap.xml
+- Repository: ${LLMS_DATA.repository}
+
+## Tech Stack
+
+${LLMS_DATA.techStack.map((item) => `- ${item}`).join("\n")}
+
+## Features
+
+${LLMS_DATA.features.map((item) => `- ${item}`).join("\n")}
+`;
+
+  return new Response(content, {
+    headers: {
+      "Content-Type": "text/plain; charset=utf-8",
+      "Cache-Control": "public, max-age=3600, s-maxage=86400",
+    },
+  });
+}

package/templates/base/src/app/manifest.ts

@@ -0,0 +1,61 @@
+import type { MetadataRoute } from "next";
+
+import { SITE_CONFIG } from "@/config/site";
+
+export default function manifest(): MetadataRoute.Manifest {
+  return {
+    name: SITE_CONFIG.name,
+    short_name: SITE_CONFIG.name,
+    description: SITE_CONFIG.description,
+    icons: [
+      {
+        src: "/favicon/favicon.svg",
+        type: "image/svg+xml",
+        sizes: "any",
+        purpose: "any",
+      },
+      {
+        src: "/favicon/web-app-manifest-192x192.png",
+        type: "image/png",
+        sizes: "192x192",
+        purpose: "any",
+      },
+      {
+        src: "/favicon/web-app-manifest-512x512.png",
+        type: "image/png",
+        sizes: "512x512",
+        purpose: "maskable",
+      },
+    ],
+    id: "/?utm_source=pwa",
+    start_url: "/?utm_source=pwa",
+    display: "standalone",
+    scope: "/",
+    screenshots: [
+      {
+        src: "/images/screenshot-mobile-dark.webp",
+        type: "image/webp",
+        sizes: "440x956",
+        form_factor: "narrow",
+      },
+      {
+        src: "/images/screenshot-mobile-light.webp",
+        type: "image/webp",
+        sizes: "440x956",
+        form_factor: "narrow",
+      },
+      {
+        src: "/images/screenshot-desktop-dark.webp",
+        type: "image/webp",
+        sizes: "1920x1080",
+        form_factor: "wide",
+      },
+      {
+        src: "/images/screenshot-desktop-light.webp",
+        type: "image/webp",
+        sizes: "1920x1080",
+        form_factor: "wide",
+      },
+    ],
+  };
+}

package/templates/base/src/app/page.tsx

@@ -0,0 +1,63 @@
+import Link from "next/link";
+import { ThemeToggle } from "@/components/theme-toggle";
+import { CopyableCode } from "@/components/copyable-code";
+
+export default function Home() {
+  return (
+    <div className="relative flex min-h-screen items-center justify-center px-6">
+      <div className="absolute top-6 right-6">
+        <ThemeToggle />
+      </div>
+      <main className="max-w-xl text-center">
+        <p className="text-xs font-medium tracking-[0.2em] text-neutral-500 uppercase dark:text-neutral-500">
+          AudoraLabs
+        </p>
+
+        <h1 className="mt-6 text-4xl font-semibold tracking-tight text-neutral-950 sm:text-5xl dark:text-white">
+          next-starter
+        </h1>
+
+        <p className="mx-auto mt-6 max-w-md text-lg text-neutral-600 dark:text-neutral-400">
+          Production-ready Next.js starter with sane defaults.
+        </p>
+
+        <div className="mt-10 flex flex-col items-center gap-4 sm:flex-row sm:justify-center">
+          <Link
+            href="https://github.com/AudoraLabs/next-starter"
+            target="_blank"
+            rel="noopener noreferrer"
+            className="inline-flex h-11 items-center justify-center rounded-md bg-neutral-950 px-6 text-sm font-medium text-white transition-colors hover:bg-neutral-800 dark:bg-white dark:text-neutral-950 dark:hover:bg-neutral-200"
+          >
+            Get Started
+          </Link>
+          <Link
+            href="https://github.com/AudoraLabs"
+            target="_blank"
+            rel="noopener noreferrer"
+            className="text-sm text-neutral-600 transition-colors hover:text-neutral-950 dark:text-neutral-500 dark:hover:text-white"
+          >
+            View on GitHub
+          </Link>
+        </div>
+
+        <CopyableCode code="bun create audora-next my-app" />
+      </main>
+
+      <footer className="absolute right-0 bottom-6 left-0 flex justify-center gap-4">
+        <Link
+          href="/llms.txt"
+          className="text-xs text-neutral-500 transition-colors hover:text-neutral-950 dark:hover:text-white"
+        >
+          llms.txt
+        </Link>
+        <span className="text-neutral-300 dark:text-neutral-700">·</span>
+        <Link
+          href="/llms-full.txt"
+          className="text-xs text-neutral-500 transition-colors hover:text-neutral-950 dark:hover:text-white"
+        >
+          llms-full.txt
+        </Link>
+      </footer>
+    </div>
+  );
+}

package/templates/base/src/app/robots.ts

@@ -0,0 +1,16 @@
+import type { MetadataRoute } from "next";
+
+import { SITE_CONFIG } from "@/config/site";
+
+export default function robots(): MetadataRoute.Robots {
+  return {
+    rules: [
+      {
+        userAgent: "*",
+        allow: "/",
+        disallow: ["/api/", "/_next/", "/private/"],
+      },
+    ],
+    sitemap: `${SITE_CONFIG.url}/sitemap.xml`,
+  };
+}

package/templates/base/src/app/sitemap.ts

@@ -0,0 +1,41 @@
+import type { MetadataRoute } from "next";
+import { SITE_CONFIG } from "@/config/site";
+
+export const dynamic = "force-static";
+
+/**
+ * Generates a comprehensive sitemap for the website
+ *
+ * Priority guidelines:
+ * - 1.0: Homepage (most important)
+ * - 0.8-0.9: Main pages (About, Blog listing, etc.)
+ * - 0.6-0.7: Blog posts, category pages
+ * - 0.4-0.5: Archive pages, tag pages
+ * - 0.3: Less important pages
+ *
+ * Change frequency guidelines:
+ * - always: Pages that change with every access
+ * - hourly: Pages that change hourly
+ * - daily: Pages that change daily
+ * - weekly: Pages that change weekly
+ * - monthly: Pages that change monthly
+ * - yearly: Pages that change yearly
+ * - never: Archived pages
+ */
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const siteUrl = SITE_CONFIG.url;
+  const currentDate = new Date().toISOString();
+
+  // Static routes with priorities and change frequencies
+  const staticRoutes: MetadataRoute.Sitemap = [
+    {
+      url: siteUrl,
+      lastModified: currentDate,
+      changeFrequency: "weekly",
+      priority: 1.0,
+    },
+  ];
+
+  return staticRoutes;
+}

package/templates/base/src/components/copyable-code.tsx

@@ -0,0 +1,41 @@
+"use client";
+
+import { useState } from "react";
+import { CopyIcon, CheckIcon } from "./icons";
+
+interface CopyableCodeProps {
+  code: string;
+}
+
+export const CopyableCode = ({ code }: CopyableCodeProps) => {
+  const [copied, setCopied] = useState(false);
+
+  const handleCopy = async () => {
+    try {
+      await navigator.clipboard.writeText(code);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2000);
+    } catch (err) {
+      console.error("Failed to copy:", err);
+    }
+  };
+
+  return (
+    <div className="relative mx-auto mt-12 max-w-lg rounded-md border border-neutral-200 bg-neutral-200 p-4 pr-12 dark:border-neutral-800 dark:bg-neutral-900">
+      <button
+        onClick={handleCopy}
+        className="absolute top-3 right-3 inline-flex h-8 w-8 items-center justify-center rounded-md text-neutral-600 transition-colors hover:bg-neutral-300 hover:text-neutral-950 dark:text-neutral-400 dark:hover:bg-neutral-800 dark:hover:text-neutral-200"
+        aria-label="Copy code"
+      >
+        {copied ? (
+          <CheckIcon className="h-4 w-4" />
+        ) : (
+          <CopyIcon className="h-4 w-4" />
+        )}
+      </button>
+      <code className="block text-xs text-neutral-700 md:text-sm dark:text-neutral-300">
+        <span className="text-neutral-400 dark:text-neutral-600">$</span> {code}
+      </code>
+    </div>
+  );
+};

package/templates/base/src/components/icons.tsx

@@ -0,0 +1,84 @@
+export const MoonIcon = ({ className }: { className?: string }) => {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      width="20"
+      height="20"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth="2"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      className={className}
+    >
+      <path d="M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z" />
+    </svg>
+  );
+};
+
+export const SunIcon = ({ className }: { className?: string }) => {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      width="20"
+      height="20"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth="2"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      className={className}
+    >
+      <circle cx="12" cy="12" r="4" />
+      <path d="M12 2v2" />
+      <path d="M12 20v2" />
+      <path d="m4.93 4.93 1.41 1.41" />
+      <path d="m17.66 17.66 1.41 1.41" />
+      <path d="M2 12h2" />
+      <path d="M20 12h2" />
+      <path d="m6.34 17.66-1.41 1.41" />
+      <path d="m19.07 4.93-1.41 1.41" />
+    </svg>
+  );
+};
+
+export const CopyIcon = ({ className }: { className?: string }) => {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      width="16"
+      height="16"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth="2"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      className={className}
+    >
+      <rect width="14" height="14" x="8" y="8" rx="2" ry="2" />
+      <path d="M4 16c-1.1 0-2-.9-2-2V6c0-1.1.9-2 2-2h8c1.1 0 2 .9 2 2" />
+    </svg>
+  );
+};
+
+export const CheckIcon = ({ className }: { className?: string }) => {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      width="16"
+      height="16"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth="2"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      className={className}
+    >
+      <path d="M20 6 9 17l-5-5" />
+    </svg>
+  );
+};

package/templates/base/src/components/theme-provider.tsx

@@ -0,0 +1,11 @@
+"use client";
+
+import { ThemeProvider as NextThemesProvider } from "next-themes";
+import type { ComponentProps } from "react";
+
+export function ThemeProvider({
+  children,
+  ...props
+}: ComponentProps<typeof NextThemesProvider>) {
+  return <NextThemesProvider {...props}>{children}</NextThemesProvider>;
+}

package/templates/base/src/components/theme-toggle.tsx

@@ -0,0 +1,20 @@
+"use client";
+
+import { useTheme } from "next-themes";
+import { MoonIcon, SunIcon } from "./icons";
+
+export const ThemeToggle = () => {
+  const { setTheme, resolvedTheme } = useTheme();
+
+  return (
+    <button
+      onClick={() => setTheme(resolvedTheme === "dark" ? "light" : "dark")}
+      className="inline-flex h-9 w-9 items-center justify-center rounded-md text-sm font-medium transition-colors hover:bg-zinc-100 focus-visible:ring-1 focus-visible:ring-zinc-950 focus-visible:outline-none disabled:pointer-events-none disabled:opacity-50 dark:hover:bg-zinc-800 dark:focus-visible:ring-zinc-300"
+      aria-label="Toggle theme"
+    >
+      <SunIcon className="hidden text-white dark:block" />
+      <MoonIcon className="block text-zinc-950 dark:hidden" />
+      <span className="sr-only">Toggle theme</span>
+    </button>
+  );
+};

package/templates/base/src/config/site.ts

@@ -0,0 +1,18 @@
+import SITE_DATA from "@/data/site";
+
+export const SITE_CONFIG = {
+  name: SITE_DATA.name,
+  url: SITE_DATA.url,
+  ogImage: SITE_DATA.ogImage,
+  tagline: SITE_DATA.tagline,
+  description: SITE_DATA.description,
+  shortDescription: SITE_DATA.shortDescription,
+  alternateNames: SITE_DATA.alternateNames,
+  twitterHandle: SITE_DATA.twitterHandle,
+  keywords: SITE_DATA.keywords,
+};
+
+export const META_THEME_COLORS = {
+  light: "#ededed",
+  dark: "#09090b",
+};

package/templates/base/src/data/llms.ts

@@ -0,0 +1,112 @@
+const LLMS_DATA = {
+  // Quick start command for cloning the starter
+  quickStart: "bunx degit AudoraLabs/next-starter my-app",
+
+  // GitHub repository URL
+  repository: "https://github.com/AudoraLabs/next-starter",
+
+  // Tech stack summary
+  techStack: [
+    "Next.js 16 with App Router",
+    "React 19",
+    "TypeScript (strict mode)",
+    "Tailwind CSS 4",
+    "Bun (package manager)",
+    "ESLint 9 (flat config)",
+    "Prettier",
+    "React Compiler",
+  ],
+
+  // Key features for the summary
+  features: [
+    "SEO-ready with robots.ts, sitemap.ts, and Open Graph metadata",
+    "Title templates and metadataBase configured",
+    "Path alias @/* mapped to ./src/*",
+    "Dark mode support via CSS custom properties",
+    "Geist font family pre-configured",
+    "Pre-commit hooks with Husky and lint-staged",
+  ],
+
+  // Folder structure for llms-full.txt
+  folderStructure: `src/
+├── app/
+│   ├── layout.tsx       # Root layout with metadata
+│   ├── page.tsx         # Home page
+│   ├── manifest.ts      # PWA manifest
+│   ├── robots.ts        # robots.txt generation
+│   ├── sitemap.ts       # Sitemap generation
+│   ├── llms.txt/        # AI-friendly summary (this file)
+│   └── llms-full.txt/   # AI-friendly full documentation
+├── components/
+│   ├── icons.tsx        # Icon components
+│   ├── theme-provider.tsx  # Theme context provider
+│   └── theme-toggle.tsx    # Dark/light mode toggle
+├── config/
+│   └── site.ts          # Site configuration exports
+├── data/
+│   ├── site.ts          # Site data (name, URL, description)
+│   └── llms.ts          # LLMs.txt content configuration
+├── lib/
+│   └── seo.ts           # SEO utilities and JSON-LD generators
+├── styles/
+│   └── globals.css      # Global styles and Tailwind imports
+└── utils/
+    └── cn.ts            # Class name utility`,
+
+  // Development commands
+  commands: {
+    dev: "bun dev",
+    build: "bun run build",
+    start: "bun start",
+    lint: "bun lint",
+    format: "bun format",
+  },
+
+  // SEO documentation for llms-full.txt
+  seoDetails: `## SEO Configuration
+
+This starter includes production-ready SEO defaults:
+
+### Metadata (src/lib/seo.ts)
+- getMetadata(): Default site metadata with Open Graph and Twitter cards
+- getPageMetadata(): Page-specific metadata generator
+- getViewport(): Viewport configuration with theme colors
+
+### Structured Data (JSON-LD)
+- getWebSiteJsonLd(): WebSite schema
+- getOrganizationJsonLd(): Organization schema
+- getBreadcrumbJsonLd(): Breadcrumb navigation schema
+
+### Configuration (src/data/site.ts)
+Customize these values for your project:
+- name: Site name
+- url: Base URL for canonical links
+- ogImage: Default Open Graph image
+- tagline: Short tagline
+- description: Full description
+- twitterHandle: Twitter/X handle
+
+### Files
+- robots.ts: Generates robots.txt with sitemap reference
+- sitemap.ts: Dynamic sitemap generation
+- manifest.ts: PWA web app manifest`,
+
+  // Conventions documentation
+  conventions: `## Conventions
+
+### Path Aliases
+Use @/* to import from src/*:
+- import { cn } from "@/utils/cn"
+- import { SITE_CONFIG } from "@/config/site"
+
+### Theme
+Dark mode uses CSS custom properties. Toggle with ThemeProvider and ThemeToggle components.
+
+### Components
+No component library included by default. Add shadcn/ui or Radix as needed.
+
+### Styling
+Tailwind CSS 4 with PostCSS. Global styles in src/styles/globals.css.`,
+};
+
+export default LLMS_DATA;

package/templates/base/src/data/site.ts

@@ -0,0 +1,30 @@
+const SITE_DATA = {
+  name: "next-starter",
+  url: process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000",
+  ogImage: process.env.NEXT_PUBLIC_OG_IMAGE ?? "http://localhost:3000/images/screenshot-desktop-dark.webp",
+
+  tagline: "Kickstart your Next.js projects effortlessly",
+  description:
+    "next-starter is a powerful, boilerplate project designed to accelerate the development of high-quality Next.js applications with best practices built-in.",
+  shortDescription:
+    "A boilerplate to quickly launch robust Next.js apps with best practices.",
+
+  alternateNames: ["next-starter", "Next Starter", "NextJS Starter"],
+
+  twitterHandle: "@nextstarter",
+
+  keywords: [
+    "next-starter",
+    "next.js starter",
+    "react boilerplate",
+    "next.js boilerplate",
+    "nextjs template",
+    "starter project",
+    "next.js template",
+    "typescript nextjs starter",
+    "boilerplate for next.js",
+    "web app starter",
+  ],
+};
+
+export default SITE_DATA;