create-stackr 0.2.0

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

@@ -0,0 +1,92 @@
+import Link from "next/link";
+import { Button } from "@/components/ui/button";
+import { ThemeToggle } from "@/components/theme-toggle";
+
+export default function Home() {
+  return (
+    <div className="min-h-screen flex flex-col bg-background">
+      {/* Navbar */}
+      <header className="fixed top-0 w-full border-b border-border/40 bg-background/80 backdrop-blur-xl z-50">
+        <div className="max-w-7xl mx-auto px-6 h-16 flex items-center justify-between">
+          <Link href="/" className="text-lg font-bold tracking-tight flex items-center gap-2">
+            <div className="h-6 w-6 rounded-md bg-primary flex items-center justify-center">
+              <span className="text-primary-foreground text-xs font-bold">A</span>
+            </div>
+            <%= projectName %>
+          </Link>
+          <div className="flex items-center gap-4">
+            <ThemeToggle />
+            <Link href="/login" className="hidden sm:block">
+              <Button variant="ghost" className="text-muted-foreground hover:text-foreground">Sign in</Button>
+            </Link>
+            <Link href="/register">
+              <Button className="font-medium shadow-lg shadow-primary/20">Get started</Button>
+            </Link>
+          </div>
+        </div>
+      </header>
+
+      {/* Hero Section */}
+      <main className="flex-1 flex flex-col">
+        <section className="relative pt-32 pb-24 lg:pt-48 lg:pb-32 overflow-hidden">
+          <div className="max-w-7xl mx-auto px-6 text-center space-y-10">
+            {/* Announcement Pill */}
+            <div className="fade-in-up delay-100 flex justify-center">
+              <div className="inline-flex items-center gap-2 px-3 py-1 rounded-full border border-border/50 bg-background/50 backdrop-blur-sm text-sm text-muted-foreground hover:bg-muted/50 transition-colors cursor-pointer">
+                <span className="relative flex h-2 w-2">
+                  <span className="animate-ping absolute inline-flex h-full w-full rounded-full bg-primary opacity-75" />
+                  <span className="relative inline-flex rounded-full h-2 w-2 bg-primary" />
+                </span>
+                <span className="font-medium">v1.0 is now live</span>
+                <span className="text-muted-foreground/50">|</span>
+                <span className="hidden sm:inline">Check out what's new &rarr;</span>
+              </div>
+            </div>
+
+            {/* Headline */}
+            <div className="space-y-6 max-w-4xl mx-auto">
+              <h1 className="text-5xl sm:text-6xl lg:text-7xl font-bold tracking-tight text-foreground leading-[1.1] sm:leading-[1.1]">
+                Build something <br className="hidden sm:block" />
+                <span className="text-foreground">
+                  remarkable today.
+                </span>
+              </h1>
+
+              <p className="text-lg sm:text-xl text-muted-foreground max-w-2xl mx-auto leading-relaxed">
+                Ship your next big idea with authentication, premium UI components, and solid engineering practices built-in.
+              </p>
+            </div>
+
+            {/* CTAs */}
+            <div className="flex flex-col sm:flex-row items-center justify-center gap-4 pt-4">
+              <Link href="/register">
+                <Button size="lg" className="h-12 px-8 text-base shadow-xl shadow-primary/20 hover:shadow-primary/30 transition-all duration-300">
+                  Start building free
+                </Button>
+              </Link>
+              <Link href="/login">
+                <Button variant="outline" size="lg" className="h-12 px-8 text-base backdrop-blur-sm hover:bg-muted/50">
+                  View demo
+                </Button>
+              </Link>
+            </div>
+          </div>
+        </section>
+      </main>
+
+      {/* Slimmer Footer */}
+      <footer className="border-t border-border/40 py-6 bg-muted/20">
+        <div className="max-w-7xl mx-auto px-6 flex flex-col sm:flex-row items-center justify-between gap-4">
+          <p className="text-sm text-muted-foreground">
+            &copy; {new Date().getFullYear()} <%= projectName %>.
+          </p>
+          <div className="flex gap-6 text-sm text-muted-foreground">
+            <Link href="#" className="hover:text-foreground transition-colors">Privacy</Link>
+            <Link href="#" className="hover:text-foreground transition-colors">Terms</Link>
+            <Link href="#" className="hover:text-foreground transition-colors">GitHub</Link>
+          </div>
+        </div>
+      </footer>
+    </div>
+  );
+}

package/templates/base/web/src/components/auth/auth-hydrator.tsx.ejs

@@ -0,0 +1,19 @@
+"use client";
+
+import { useEffect } from "react";
+import { useAuthStore } from "@/store/auth.store";
+import type { AuthSession } from "@/lib/auth/actions";
+
+/**
+ * Hydrates the auth store with the initial session from RSC.
+ * Renders nothing - just a side effect component.
+ */
+export function AuthHydrator({ session }: { session: AuthSession | null }) {
+  const hydrate = useAuthStore((s) => s.hydrate);
+
+  useEffect(() => {
+    hydrate(session);
+  }, [hydrate, session]);
+
+  return null;
+}

package/templates/base/web/src/components/auth/protected-route.tsx.ejs

@@ -0,0 +1,109 @@
+"use client";
+
+import { useEffect, useCallback } from "react";
+import { useRouter } from "next/navigation";
+import { useSession } from "@/hooks/use-session";
+import { getSession } from "@/lib/auth/actions";
+import { useAuthActions } from "@/store/auth.store";
+
+interface ProtectedRouteProps {
+  children: React.ReactNode;
+  /**
+   * URL to redirect to if not authenticated
+   * @default "/login"
+   */
+  redirectTo?: string;
+  /**
+   * Custom loading component
+   */
+  loadingComponent?: React.ReactNode;
+}
+
+/**
+ * Client-side route protection component
+ *
+ * Wraps content that should only be visible to authenticated users.
+ * Redirects to login if user is not authenticated.
+ *
+ * Note: For server-side protection, use the proxy or check session
+ * in server components. This component provides client-side protection
+ * as an additional layer.
+ *
+ * @example
+ * ```tsx
+ * <ProtectedRoute>
+ *   <DashboardContent />
+ * </ProtectedRoute>
+ * ```
+ */
+export function ProtectedRoute({
+  children,
+  redirectTo = "/login",
+  loadingComponent,
+}: ProtectedRouteProps) {
+  const { isAuthenticated, isLoading } = useSession();
+  const { handleAuthError } = useAuthActions();
+  const router = useRouter();
+
+  // Revalidate session when window regains focus
+  // This detects session expiration when user returns to the tab
+  const revalidateSession = useCallback(async () => {
+    if (!isAuthenticated) return;
+
+    const session = await getSession();
+    if (!session) {
+      // Session expired on backend - update UI state
+      handleAuthError();
+    }
+  }, [isAuthenticated, handleAuthError]);
+
+  // Focus-based revalidation
+  useEffect(() => {
+    window.addEventListener("focus", revalidateSession);
+    return () => window.removeEventListener("focus", revalidateSession);
+  }, [revalidateSession]);
+
+  // Redirect when not authenticated
+  useEffect(() => {
+    if (!isLoading && !isAuthenticated) {
+      // Include current path as redirect parameter
+      const currentPath = window.location.pathname;
+      const loginUrl = `${redirectTo}?redirect=${encodeURIComponent(currentPath)}`;
+      router.push(loginUrl);
+    }
+  }, [isAuthenticated, isLoading, redirectTo, router]);
+
+  // Show loading state
+  if (isLoading) {
+    return (
+      loadingComponent ?? (
+        <div className="flex min-h-screen items-center justify-center">
+          <div className="h-8 w-8 animate-spin rounded-full border-4 border-primary border-t-transparent" />
+        </div>
+      )
+    );
+  }
+
+  // Don't render content if not authenticated
+  if (!isAuthenticated) {
+    return null;
+  }
+
+  return <>{children}</>;
+}
+
+/**
+ * HOC version of ProtectedRoute for class components or convenience
+ */
+export function withProtectedRoute<P extends object>(
+  Component: React.ComponentType<P>,
+  options?: Omit<ProtectedRouteProps, "children">
+) {
+  return function ProtectedComponent(props: P) {
+    return (
+      <ProtectedRoute {...options}>
+        <Component {...props} />
+      </ProtectedRoute>
+    );
+  };
+}

package/templates/base/web/src/components/providers/device-session-setup.tsx.ejs

@@ -0,0 +1,56 @@
+"use client";
+
+import { useEffect } from "react";
+import {
+  useDeviceSessionStore,
+  useDeviceSessionActions,
+} from "@/store/deviceSession.store";
+import { AUTH_CONFIG } from "@/lib/auth/config";
+
+/**
+ * DeviceSessionSetup handles:
+ * 1. Session initialization on mount
+ * 2. Periodic heartbeat (every 5 minutes)
+ * 3. Visibility-based activity updates
+ */
+export function DeviceSessionSetup() {
+  const deviceSession = useDeviceSessionStore((s) => s.deviceSession);
+  const isInitialized = useDeviceSessionStore((s) => s.isInitialized);
+  const { initializeSession, sendHeartbeat } = useDeviceSessionActions();
+
+  // Initialize on mount
+  useEffect(() => {
+    if (!isInitialized) {
+      initializeSession();
+    }
+  }, [isInitialized, initializeSession]);
+
+  // Heartbeat - update activity every 5 minutes
+  useEffect(() => {
+    if (!deviceSession) return;
+
+    const interval = setInterval(() => {
+      sendHeartbeat();
+    }, AUTH_CONFIG.deviceHeartbeatInterval);
+
+    return () => clearInterval(interval);
+  }, [deviceSession, sendHeartbeat]);
+
+  // Update activity on visibility change (tab becomes visible)
+  useEffect(() => {
+    if (!deviceSession) return;
+
+    const handleVisibilityChange = () => {
+      if (document.visibilityState === "visible") {
+        sendHeartbeat();
+      }
+    };
+
+    document.addEventListener("visibilitychange", handleVisibilityChange);
+    return () => {
+      document.removeEventListener("visibilitychange", handleVisibilityChange);
+    };
+  }, [deviceSession, sendHeartbeat]);
+
+  return null;
+}

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

@@ -0,0 +1,17 @@
+"use client";
+
+import * as React from "react";
+import { ThemeProvider as NextThemesProvider } from "next-themes";
+
+export function ThemeProvider({ children }: { children: React.ReactNode }) {
+  return (
+    <NextThemesProvider
+      attribute="class"
+      defaultTheme="system"
+      enableSystem
+      disableTransitionOnChange
+    >
+      {children}
+    </NextThemesProvider>
+  );
+}

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

@@ -0,0 +1,34 @@
+"use client";
+
+import * as React from "react";
+import { Moon, Sun } from "lucide-react";
+import { useTheme } from "next-themes";
+import { Button } from "@/components/ui/button";
+
+export function ThemeToggle() {
+  const { setTheme, resolvedTheme } = useTheme();
+  const [mounted, setMounted] = React.useState(false);
+
+  // Avoid hydration mismatch by only rendering after mount
+  React.useEffect(() => setMounted(true), []);
+
+  if (!mounted) {
+    return (
+      <Button variant="ghost" size="icon" aria-label="Toggle theme">
+        <span className="h-5 w-5" />
+      </Button>
+    );
+  }
+
+  return (
+    <Button
+      variant="ghost"
+      size="icon"
+      onClick={() => setTheme(resolvedTheme === "dark" ? "light" : "dark")}
+      aria-label="Toggle theme"
+    >
+      <Sun className="h-5 w-5 rotate-0 scale-100 transition-transform dark:-rotate-90 dark:scale-0" />
+      <Moon className="absolute h-5 w-5 rotate-90 scale-0 transition-transform dark:rotate-0 dark:scale-100" />
+    </Button>
+  );
+}

package/templates/base/web/src/components/ui/button.tsx

@@ -0,0 +1,62 @@
+import * as React from "react"
+import { Slot } from "@radix-ui/react-slot"
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "@/lib/utils"
+
+const buttonVariants = cva(
+  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
+  {
+    variants: {
+      variant: {
+        default: "bg-primary text-primary-foreground hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-white hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
+        outline:
+          "border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50",
+        secondary:
+          "bg-secondary text-secondary-foreground hover:bg-secondary/80",
+        ghost:
+          "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-9 px-4 py-2 has-[>svg]:px-3",
+        sm: "h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5",
+        lg: "h-10 rounded-md px-6 has-[>svg]:px-4",
+        icon: "size-9",
+        "icon-sm": "size-8",
+        "icon-lg": "size-10",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+)
+
+function Button({
+  className,
+  variant = "default",
+  size = "default",
+  asChild = false,
+  ...props
+}: React.ComponentProps<"button"> &
+  VariantProps<typeof buttonVariants> & {
+    asChild?: boolean
+  }) {
+  const Comp = asChild ? Slot : "button"
+
+  return (
+    <Comp
+      data-slot="button"
+      data-variant={variant}
+      data-size={size}
+      className={cn(buttonVariants({ variant, size, className }))}
+      {...props}
+    />
+  )
+}
+
+export { Button, buttonVariants }

package/templates/base/web/src/components/ui/card.tsx

@@ -0,0 +1,92 @@
+import * as React from "react"
+
+import { cn } from "@/lib/utils"
+
+function Card({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card"
+      className={cn(
+        "bg-card text-card-foreground flex flex-col gap-6 rounded-xl border py-6 shadow-sm",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-header"
+      className={cn(
+        "@container/card-header grid auto-rows-min grid-rows-[auto_auto] items-start gap-2 px-6 has-data-[slot=card-action]:grid-cols-[1fr_auto] [.border-b]:pb-6",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-title"
+      className={cn("leading-none font-semibold", className)}
+      {...props}
+    />
+  )
+}
+
+function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-description"
+      className={cn("text-muted-foreground text-sm", className)}
+      {...props}
+    />
+  )
+}
+
+function CardAction({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-action"
+      className={cn(
+        "col-start-2 row-span-2 row-start-1 self-start justify-self-end",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardContent({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-content"
+      className={cn("px-6", className)}
+      {...props}
+    />
+  )
+}
+
+function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-footer"
+      className={cn("flex items-center px-6 [.border-t]:pt-6", className)}
+      {...props}
+    />
+  )
+}
+
+export {
+  Card,
+  CardHeader,
+  CardFooter,
+  CardTitle,
+  CardAction,
+  CardDescription,
+  CardContent,
+}

package/templates/base/web/src/components/ui/input.tsx

@@ -0,0 +1,21 @@
+import * as React from "react"
+
+import { cn } from "@/lib/utils"
+
+function Input({ className, type, ...props }: React.ComponentProps<"input">) {
+  return (
+    <input
+      type={type}
+      data-slot="input"
+      className={cn(
+        "file:text-foreground placeholder:text-muted-foreground selection:bg-primary selection:text-primary-foreground dark:bg-input/30 border-input h-9 w-full min-w-0 rounded-md border bg-transparent px-3 py-1 text-base shadow-xs transition-[color,box-shadow] outline-none file:inline-flex file:h-7 file:border-0 file:bg-transparent file:text-sm file:font-medium disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+        "focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]",
+        "aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Input }

package/templates/base/web/src/components/ui/label.tsx

@@ -0,0 +1,24 @@
+"use client"
+
+import * as React from "react"
+import * as LabelPrimitive from "@radix-ui/react-label"
+
+import { cn } from "@/lib/utils"
+
+function Label({
+  className,
+  ...props
+}: React.ComponentProps<typeof LabelPrimitive.Root>) {
+  return (
+    <LabelPrimitive.Root
+      data-slot="label"
+      className={cn(
+        "flex items-center gap-2 text-sm leading-none font-medium select-none group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50 peer-disabled:cursor-not-allowed peer-disabled:opacity-50",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Label }

package/templates/base/web/src/components/ui/skeleton.tsx

@@ -0,0 +1,13 @@
+import { cn } from "@/lib/utils"
+
+function Skeleton({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="skeleton"
+      className={cn("bg-accent animate-pulse rounded-md", className)}
+      {...props}
+    />
+  )
+}
+
+export { Skeleton }

package/templates/base/web/src/components/ui/spinner.tsx

@@ -0,0 +1,20 @@
+import { cn } from "@/lib/utils";
+
+interface SpinnerProps {
+  size?: "sm" | "md" | "lg";
+  className?: string;
+}
+
+export function Spinner({ size = "md", className }: SpinnerProps) {
+  const sizes = { sm: "h-4 w-4 border-2", md: "h-6 w-6 border-2", lg: "h-8 w-8 border-[3px]" };
+
+  return (
+    <div
+      className={cn("animate-spin rounded-full border-muted-foreground border-t-primary", sizes[size], className)}
+      role="status"
+      aria-label="Loading"
+    >
+      <span className="sr-only">Loading...</span>
+    </div>
+  );
+}

package/templates/base/web/src/hooks/use-device-session.ts.ejs

@@ -0,0 +1,40 @@
+"use client";
+
+import {
+  useDeviceSession as useDeviceSessionStore,
+  useDeviceSessionActions,
+} from "@/store/deviceSession.store";
+
+/**
+ * Hook to access the current device session
+ *
+ * Provides a simplified interface to the device session store.
+ * Use this hook in components that need access to the device session.
+ */
+export function useDeviceSession() {
+  const { deviceSession, deviceId, isLoading, hasSession, error } = useDeviceSessionStore();
+  const { refreshSession, sendHeartbeat, clearError } = useDeviceSessionActions();
+
+  return {
+    // Session data
+    deviceSession,
+    deviceId,
+
+    // Loading state
+    isLoading,
+
+    // Convenience boolean for session checks
+    hasSession,
+
+    // Error state
+    error,
+
+    // Actions
+    refreshSession,
+    sendHeartbeat,
+    clearError,
+  };
+}
+
+// Re-export store hooks for direct access when needed
+export { useDeviceSessionStore, useDeviceSessionActions } from "@/store/deviceSession.store";

package/templates/base/web/src/hooks/use-session.ts.ejs

@@ -0,0 +1,56 @@
+"use client";
+
+import { useAuth, useAuthActions } from "@/store/auth.store";
+
+/**
+ * Hook to access the current session
+ *
+ * Provides a simplified interface to the auth store.
+ * Use this hook in components that need access to the current user/session.
+ */
+export function useSession() {
+  const { session, user, isLoading, isAuthenticated, error } = useAuth();
+  const { signOut, clearError } = useAuthActions();
+
+  return {
+    // Session data
+    session,
+    user,
+
+    // Loading state
+    isLoading,
+
+    // Convenience boolean for auth checks
+    isAuthenticated,
+
+    // Error state
+    error,
+
+    // Actions
+    signOut,
+    clearError,
+  };
+}
+
+/**
+ * Hook to require authentication
+ *
+ * Returns the session and throws if not authenticated.
+ * Use this in components that should only render when authenticated.
+ */
+export function useRequireSession() {
+  const { session, user, isLoading, isAuthenticated } = useAuth();
+
+  if (!isLoading && !isAuthenticated) {
+    throw new Error("Authentication required");
+  }
+
+  return {
+    session: session!,
+    user: user!,
+    isLoading,
+  };
+}
+
+// Re-export store hooks for direct access when needed
+export { useAuth, useAuthActions } from "@/store/auth.store";