create-xani-agentic-app 1.0.0

package/template/src/app/globals.css

@@ -0,0 +1,175 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --color-chart-1: var(--chart-1);
+  --color-chart-2: var(--chart-2);
+  --color-chart-3: var(--chart-3);
+  --color-chart-4: var(--chart-4);
+  --color-chart-5: var(--chart-5);
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --animate-fade-in: fade-in 0.3s ease-out;
+  --animate-fade-up: fade-up 0.4s ease-out;
+  --animate-scale-in: scale-in 0.2s ease-out;
+}
+
+:root {
+  --radius: 0.625rem;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.141 0.005 285.823);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.141 0.005 285.823);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.141 0.005 285.823);
+  --primary: oklch(0.21 0.034 270);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.967 0.001 286.375);
+  --secondary-foreground: oklch(0.21 0.006 285.885);
+  --muted: oklch(0.967 0.001 286.375);
+  --muted-foreground: oklch(0.552 0.016 285.938);
+  --accent: oklch(0.96 0.012 270);
+  --accent-foreground: oklch(0.21 0.006 285.885);
+  --destructive: oklch(0.577 0.245 27.325);
+  --border: oklch(0.92 0.004 286.32);
+  --input: oklch(0.92 0.004 286.32);
+  --ring: oklch(0.705 0.06 270);
+  --chart-1: oklch(0.646 0.222 41.116);
+  --chart-2: oklch(0.6 0.118 184.704);
+  --chart-3: oklch(0.398 0.07 227.392);
+  --chart-4: oklch(0.828 0.189 84.429);
+  --chart-5: oklch(0.769 0.188 70.08);
+  --sidebar: oklch(0.985 0 0);
+  --sidebar-foreground: oklch(0.141 0.005 285.823);
+  --sidebar-primary: oklch(0.21 0.006 285.885);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.967 0.001 286.375);
+  --sidebar-accent-foreground: oklch(0.21 0.006 285.885);
+  --sidebar-border: oklch(0.92 0.004 286.32);
+  --sidebar-ring: oklch(0.705 0.015 286.067);
+}
+
+.dark {
+  --background: oklch(0.141 0.005 285.823);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.21 0.006 285.885);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.21 0.006 285.885);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.92 0.02 270);
+  --primary-foreground: oklch(0.21 0.006 285.885);
+  --secondary: oklch(0.274 0.006 286.033);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.274 0.006 286.033);
+  --muted-foreground: oklch(0.705 0.015 286.067);
+  --accent: oklch(0.28 0.018 270);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.704 0.191 22.216);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.552 0.05 270);
+  --chart-1: oklch(0.488 0.243 264.376);
+  --chart-2: oklch(0.696 0.17 162.48);
+  --chart-3: oklch(0.769 0.188 70.08);
+  --chart-4: oklch(0.627 0.265 303.9);
+  --chart-5: oklch(0.645 0.246 16.439);
+  --sidebar: oklch(0.21 0.006 285.885);
+  --sidebar-foreground: oklch(0.985 0 0);
+  --sidebar-primary: oklch(0.488 0.243 264.376);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.274 0.006 286.033);
+  --sidebar-accent-foreground: oklch(0.985 0 0);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --sidebar-ring: oklch(0.552 0.016 285.938);
+}
+
+@keyframes fade-in {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+  }
+}
+
+@keyframes fade-up {
+  from {
+    opacity: 0;
+    transform: translateY(8px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+@keyframes scale-in {
+  from {
+    opacity: 0;
+    transform: scale(0.97);
+  }
+  to {
+    opacity: 1;
+    transform: scale(1);
+  }
+}
+
+@layer base {
+  * {
+    @apply border-border;
+  }
+  html {
+    scroll-behavior: smooth;
+  }
+  body {
+    @apply bg-background text-foreground;
+    font-feature-settings: "rlig" 1, "calt" 1;
+  }
+  :focus-visible {
+    @apply outline-2 outline-offset-2 outline-ring;
+  }
+}
+
+@layer utilities {
+  .card-interactive {
+    @apply transition-all duration-200 ease-out;
+  }
+  .card-interactive:hover {
+    @apply shadow-md -translate-y-0.5;
+  }
+  .auth-bg {
+    background-image: radial-gradient(
+      circle at 50% 0%,
+      var(--accent) 0%,
+      transparent 50%
+    );
+  }
+}

package/template/src/app/layout.tsx

@@ -0,0 +1,108 @@
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+import { SiteFooter } from "@/components/site-footer";
+import { SiteHeader } from "@/components/site-header";
+import { ThemeProvider } from "@/components/theme-provider";
+import { Toaster } from "@/components/ui/sonner";
+import type { Metadata } from "next";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
+
+export const metadata: Metadata = {
+  title: {
+    default: "Xani Agentic Starter Kit",
+    template: "%s | Xani Agentic Starter Kit",
+  },
+  description:
+    "Complete agentic coding boilerplate with authentication, database, AI integration, and modern tooling - perfect for building AI-powered applications and autonomous agents by AlexandreXavier",
+  keywords: [
+    "Next.js",
+    "React",
+    "TypeScript",
+    "AI",
+    "OpenRouter",
+    "Boilerplate",
+    "Authentication",
+    "PostgreSQL",
+  ],
+  authors: [{ name: "AlexandreXavier" }],
+  creator: "AlexandreXavier",
+  openGraph: {
+    type: "website",
+    locale: "en_US",
+    siteName: "Xani Agentic Starter Kit",
+    title: "Xani Agentic Starter Kit",
+    description:
+      "Complete agentic coding boilerplate with authentication, database, AI integration, and modern tooling",
+  },
+  twitter: {
+    card: "summary_large_image",
+    title: "Xani Agentic Starter Kit",
+    description:
+      "Complete agentic coding boilerplate with authentication, database, AI integration, and modern tooling",
+  },
+  robots: {
+    index: true,
+    follow: true,
+  },
+};
+
+// JSON-LD structured data for SEO
+const jsonLd = {
+  "@context": "https://schema.org",
+  "@type": "WebApplication",
+  name: "Xani Agentic Starter Kit",
+  description:
+    "Complete agentic coding boilerplate with authentication, database, AI integration, and modern tooling",
+  applicationCategory: "DeveloperApplication",
+  operatingSystem: "Any",
+  offers: {
+    "@type": "Offer",
+    price: "0",
+    priceCurrency: "USD",
+  },
+  author: {
+    "@type": "Person",
+    name: "AlexandreXavier",
+  },
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <head>
+        <script
+          type="application/ld+json"
+          dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
+        />
+      </head>
+      <body
+        className={`${geistSans.variable} ${geistMono.variable} antialiased min-h-screen flex flex-col`}
+      >
+        <ThemeProvider
+          attribute="class"
+          defaultTheme="system"
+          enableSystem
+          disableTransitionOnChange
+        >
+          <SiteHeader />
+          <main id="main-content" className="flex-1">{children}</main>
+          <SiteFooter />
+          <Toaster richColors position="top-right" />
+        </ThemeProvider>
+      </body>
+    </html>
+  );
+}

package/template/src/app/manifest.ts

@@ -0,0 +1,21 @@
+import type { MetadataRoute } from "next";
+
+export default function manifest(): MetadataRoute.Manifest {
+  return {
+    name: "Xani Agentic Starter Kit",
+    short_name: "Agentic",
+    description:
+      "Complete agentic coding boilerplate with authentication, database, AI integration, and modern tooling",
+    start_url: "/",
+    display: "standalone",
+    background_color: "#ffffff",
+    theme_color: "#000000",
+    icons: [
+      {
+        src: "/favicon.ico",
+        sizes: "any",
+        type: "image/x-icon",
+      },
+    ],
+  };
+}

package/template/src/app/not-found.tsx

@@ -0,0 +1,28 @@
+import Link from "next/link";
+import { FileQuestion } from "lucide-react";
+import { Button } from "@/components/ui/button";
+
+export default function NotFound() {
+  return (
+    <div className="container mx-auto px-4 py-16">
+      <div className="max-w-md mx-auto text-center">
+        <div className="flex justify-center mb-6">
+          <FileQuestion className="h-16 w-16 text-muted-foreground" />
+        </div>
+        <h1 className="text-4xl font-bold mb-4">404</h1>
+        <h2 className="text-xl font-semibold mb-4">Page Not Found</h2>
+        <p className="text-muted-foreground mb-6">
+          The page you&apos;re looking for doesn&apos;t exist or has been moved.
+        </p>
+        <div className="flex gap-4 justify-center">
+          <Button asChild>
+            <Link href="/">Go home</Link>
+          </Button>
+          <Button variant="outline" asChild>
+            <Link href="/dashboard">Dashboard</Link>
+          </Button>
+        </div>
+      </div>
+    </div>
+  );
+}

package/template/src/app/page.tsx

@@ -0,0 +1,152 @@
+"use client";
+
+import Link from "next/link";
+import { Shield, Database, Palette, Bot } from "lucide-react";
+import { SetupChecklist } from "@/components/setup-checklist";
+import { StarterPromptModal } from "@/components/starter-prompt-modal";
+import { Button } from "@/components/ui/button";
+import { useDiagnostics } from "@/hooks/use-diagnostics";
+
+export default function Home() {
+  const { isAuthReady, isAiReady, loading } = useDiagnostics();
+  return (
+    <main className="flex-1 container mx-auto px-4 py-12">
+      <div className="max-w-4xl mx-auto text-center space-y-8">
+        <div className="space-y-4">
+          <div className="flex items-center justify-center gap-3 mb-2">
+            <div className="flex items-center justify-center w-12 h-12 rounded-xl bg-primary/10">
+              <Bot className="h-7 w-7 text-primary" />
+            </div>
+            <h1 className="text-5xl font-bold tracking-tight bg-gradient-to-r from-primary via-primary/90 to-primary/70 bg-clip-text text-transparent">
+              Starter Kit
+            </h1>
+          </div>
+          <h2 className="text-2xl font-semibold text-muted-foreground">
+            Complete Boilerplate for AI Applications
+          </h2>
+          <p className="text-xl text-muted-foreground">
+            A complete agentic coding boilerplate with authentication, database, AI
+            integration, and modern tooling for building AI-powered applications
+          </p>
+        </div>
+
+        <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6 mt-12">
+          <div className="p-6 border rounded-lg">
+            <h3 className="font-semibold mb-2 flex items-center gap-2">
+              <Shield className="h-4 w-4" />
+              Authentication
+            </h3>
+            <p className="text-sm text-muted-foreground">
+              Better Auth with Google OAuth integration
+            </p>
+          </div>
+          <div className="p-6 border rounded-lg">
+            <h3 className="font-semibold mb-2 flex items-center gap-2">
+              <Database className="h-4 w-4" />
+              Database
+            </h3>
+            <p className="text-sm text-muted-foreground">
+              Drizzle ORM with PostgreSQL setup
+            </p>
+          </div>
+          <div className="p-6 border rounded-lg">
+            <h3 className="font-semibold mb-2 flex items-center gap-2">
+              <Bot className="h-4 w-4" />
+              AI Ready
+            </h3>
+            <p className="text-sm text-muted-foreground">
+              Vercel AI SDK with OpenRouter integration
+            </p>
+          </div>
+          <div className="p-6 border rounded-lg">
+            <h3 className="font-semibold mb-2 flex items-center gap-2">
+              <Palette className="h-4 w-4" />
+              UI Components
+            </h3>
+            <p className="text-sm text-muted-foreground">
+              shadcn/ui with Tailwind CSS
+            </p>
+          </div>
+        </div>
+
+        <div className="space-y-6 mt-12">
+          <SetupChecklist />
+
+          <h3 className="text-2xl font-semibold">Next Steps</h3>
+          <div className="grid grid-cols-1 md:grid-cols-2 gap-4 text-left">
+            <div className="p-4 border rounded-lg">
+              <h4 className="font-medium mb-2">
+                1. Set up environment variables
+              </h4>
+              <p className="text-sm text-muted-foreground mb-2">
+                Copy <code>.env.example</code> to <code>.env.local</code> and
+                configure:
+              </p>
+              <ul className="text-sm text-muted-foreground space-y-1 list-disc list-inside">
+                <li>POSTGRES_URL (PostgreSQL connection string)</li>
+                <li>GOOGLE_CLIENT_ID (OAuth credentials)</li>
+                <li>GOOGLE_CLIENT_SECRET (OAuth credentials)</li>
+                <li>OPENROUTER_API_KEY (for AI functionality)</li>
+              </ul>
+            </div>
+            <div className="p-4 border rounded-lg">
+              <h4 className="font-medium mb-2">2. Set up your database</h4>
+              <p className="text-sm text-muted-foreground mb-2">
+                Run database migrations:
+              </p>
+              <div className="space-y-2">
+                <code className="text-sm bg-muted p-2 rounded block">
+                  npm run db:generate
+                </code>
+                <code className="text-sm bg-muted p-2 rounded block">
+                  npm run db:migrate
+                </code>
+              </div>
+            </div>
+            <div className="p-4 border rounded-lg">
+              <h4 className="font-medium mb-2">3. Try the features</h4>
+              <div className="space-y-2">
+                {loading || !isAuthReady ? (
+                  <Button size="sm" className="w-full" disabled={true}>
+                    View Dashboard
+                  </Button>
+                ) : (
+                  <Button asChild size="sm" className="w-full">
+                    <Link href="/dashboard">View Dashboard</Link>
+                  </Button>
+                )}
+                {loading || !isAiReady ? (
+                  <Button
+                    variant="outline"
+                    size="sm"
+                    className="w-full"
+                    disabled={true}
+                  >
+                    Try AI Chat
+                  </Button>
+                ) : (
+                  <Button
+                    asChild
+                    variant="outline"
+                    size="sm"
+                    className="w-full"
+                  >
+                    <Link href="/chat">Try AI Chat</Link>
+                  </Button>
+                )}
+              </div>
+            </div>
+            <div className="p-4 border rounded-lg">
+              <h4 className="font-medium mb-2">4. Start building</h4>
+              <p className="text-sm text-muted-foreground mb-3">
+                Customize the components, add your own pages, and build your
+                application on top of this solid foundation.
+              </p>
+              <StarterPromptModal />
+            </div>
+          </div>
+        </div>
+      </div>
+    </main>
+  );
+}