fastapi-fullstack 0.1.2__py3-none-any.whl

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/components/theme/theme-provider.tsx

@@ -0,0 +1,53 @@
+{%- if cookiecutter.use_frontend %}
+"use client";
+
+import { useEffect } from "react";
+import { useThemeStore, getResolvedTheme } from "@/stores/theme-store";
+
+interface ThemeProviderProps {
+  children: React.ReactNode;
+}
+
+export function ThemeProvider({ children }: ThemeProviderProps) {
+  const { theme } = useThemeStore();
+
+  useEffect(() => {
+    const root = document.documentElement;
+    const resolvedTheme = getResolvedTheme(theme);
+
+    // Remove both classes first
+    root.classList.remove("light", "dark");
+    // Add the current theme class
+    root.classList.add(resolvedTheme);
+
+    // Update color-scheme for native elements
+    root.style.colorScheme = resolvedTheme;
+  }, [theme]);
+
+  // Listen for system theme changes when using "system" theme
+  useEffect(() => {
+    if (theme !== "system") return;
+
+    const mediaQuery = window.matchMedia("(prefers-color-scheme: dark)");
+
+    const handleChange = () => {
+      const root = document.documentElement;
+      const resolvedTheme = mediaQuery.matches ? "dark" : "light";
+
+      root.classList.remove("light", "dark");
+      root.classList.add(resolvedTheme);
+      root.style.colorScheme = resolvedTheme;
+    };
+
+    mediaQuery.addEventListener("change", handleChange);
+    return () => mediaQuery.removeEventListener("change", handleChange);
+  }, [theme]);
+
+  return <>{children}</>;
+}
+{%- else %}
+/* Theme provider - frontend not configured */
+export function ThemeProvider({ children }: { children: React.ReactNode }) {
+  return <>{children}</>;
+}
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/components/theme/theme-toggle.tsx

@@ -0,0 +1,83 @@
+{%- if cookiecutter.use_frontend %}
+"use client";
+
+import { Moon, Sun, Monitor } from "lucide-react";
+import { Button } from "@/components/ui/button";
+import { useThemeStore, Theme, getResolvedTheme } from "@/stores/theme-store";
+
+interface ThemeToggleProps {
+  variant?: "icon" | "dropdown";
+  className?: string;
+}
+
+export function ThemeToggle({ variant = "icon", className }: ThemeToggleProps) {
+  const { theme, setTheme } = useThemeStore();
+  const resolvedTheme = getResolvedTheme(theme);
+
+  const cycleTheme = () => {
+    const themes: Theme[] = ["light", "dark", "system"];
+    const currentIndex = themes.indexOf(theme);
+    const nextIndex = (currentIndex + 1) % themes.length;
+    setTheme(themes[nextIndex]);
+  };
+
+  if (variant === "icon") {
+    return (
+      <Button
+        variant="ghost"
+        size="icon"
+        onClick={cycleTheme}
+        className={className}
+        aria-label={`Switch theme (current: ${theme})`}
+        title={`Theme: ${theme}`}
+      >
+        {resolvedTheme === "dark" ? (
+          <Moon className="h-5 w-5" />
+        ) : (
+          <Sun className="h-5 w-5" />
+        )}
+        {theme === "system" && (
+          <span className="sr-only">(following system)</span>
+        )}
+      </Button>
+    );
+  }
+
+  return (
+    <div className={`flex gap-1 ${className}`}>
+      <Button
+        variant={theme === "light" ? "default" : "ghost"}
+        size="icon"
+        onClick={() => setTheme("light")}
+        aria-label="Light mode"
+        title="Light mode"
+      >
+        <Sun className="h-4 w-4" />
+      </Button>
+      <Button
+        variant={theme === "dark" ? "default" : "ghost"}
+        size="icon"
+        onClick={() => setTheme("dark")}
+        aria-label="Dark mode"
+        title="Dark mode"
+      >
+        <Moon className="h-4 w-4" />
+      </Button>
+      <Button
+        variant={theme === "system" ? "default" : "ghost"}
+        size="icon"
+        onClick={() => setTheme("system")}
+        aria-label="System theme"
+        title="System theme"
+      >
+        <Monitor className="h-4 w-4" />
+      </Button>
+    </div>
+  );
+}
+{%- else %}
+/* Theme toggle - frontend not configured */
+export function ThemeToggle() {
+  return null;
+}
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/components/ui/badge.tsx

@@ -0,0 +1,35 @@
+import * as React from "react";
+import { cva, type VariantProps } from "class-variance-authority";
+import { cn } from "@/lib/utils";
+
+const badgeVariants = cva(
+  "inline-flex items-center rounded-md border px-2.5 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2",
+  {
+    variants: {
+      variant: {
+        default:
+          "border-transparent bg-primary text-primary-foreground shadow hover:bg-primary/80",
+        secondary:
+          "border-transparent bg-secondary text-secondary-foreground hover:bg-secondary/80",
+        destructive:
+          "border-transparent bg-destructive text-destructive-foreground shadow hover:bg-destructive/80",
+        outline: "text-foreground",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  }
+);
+
+export interface BadgeProps
+  extends React.HTMLAttributes<HTMLDivElement>,
+    VariantProps<typeof badgeVariants> {}
+
+function Badge({ className, variant, ...props }: BadgeProps) {
+  return (
+    <div className={cn(badgeVariants({ variant }), className)} {...props} />
+  );
+}
+
+export { Badge, badgeVariants };

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/components/ui/button.test.tsx

@@ -0,0 +1,75 @@
+{%- if cookiecutter.use_frontend %}
+import { describe, it, expect, vi } from "vitest";
+import { render, screen, fireEvent } from "@testing-library/react";
+import { Button } from "./button";
+
+describe("Button component", () => {
+  it("should render with children", () => {
+    render(<Button>Click me</Button>);
+    expect(screen.getByRole("button", { name: /click me/i })).toBeInTheDocument();
+  });
+
+  it("should handle click events", () => {
+    const handleClick = vi.fn();
+    render(<Button onClick={handleClick}>Click me</Button>);
+
+    fireEvent.click(screen.getByRole("button"));
+    expect(handleClick).toHaveBeenCalledTimes(1);
+  });
+
+  it("should apply variant classes", () => {
+    render(<Button variant="destructive">Delete</Button>);
+    const button = screen.getByRole("button");
+    expect(button.className).toMatch(/destructive|red|danger/i);
+  });
+
+  it("should apply size classes", () => {
+    render(<Button size="lg">Large Button</Button>);
+    const button = screen.getByRole("button");
+    // Check that the button has appropriate size styling
+    expect(button).toBeInTheDocument();
+  });
+
+  it("should be disabled when disabled prop is true", () => {
+    render(<Button disabled>Disabled</Button>);
+    const button = screen.getByRole("button");
+    expect(button).toBeDisabled();
+  });
+
+  it("should not trigger click when disabled", () => {
+    const handleClick = vi.fn();
+    render(
+      <Button disabled onClick={handleClick}>
+        Disabled
+      </Button>
+    );
+
+    fireEvent.click(screen.getByRole("button"));
+    expect(handleClick).not.toHaveBeenCalled();
+  });
+
+  it("should support custom className", () => {
+    render(<Button className="custom-class">Custom</Button>);
+    const button = screen.getByRole("button");
+    expect(button.className).toContain("custom-class");
+  });
+
+  it("should render as a link when asChild is used", () => {
+    render(
+      <Button asChild>
+        <a href="/test">Link Button</a>
+      </Button>
+    );
+    expect(screen.getByRole("link")).toBeInTheDocument();
+  });
+
+  it("should support different button types", () => {
+    render(<Button type="submit">Submit</Button>);
+    const button = screen.getByRole("button");
+    expect(button).toHaveAttribute("type", "submit");
+  });
+});
+{%- else %}
+/* Button tests - frontend not configured */
+export {};
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/components/ui/button.tsx

@@ -0,0 +1,54 @@
+import * as React from "react";
+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-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0",
+  {
+    variants: {
+      variant: {
+        default:
+          "bg-primary text-primary-foreground shadow hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-destructive-foreground shadow-sm hover:bg-destructive/90",
+        outline:
+          "border border-input bg-background shadow-sm hover:bg-accent hover:text-accent-foreground",
+        secondary:
+          "bg-secondary text-secondary-foreground shadow-sm hover:bg-secondary/80",
+        ghost: "hover:bg-accent hover:text-accent-foreground",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-9 px-4 py-2",
+        sm: "h-8 rounded-md px-3 text-xs",
+        lg: "h-10 rounded-md px-8",
+        icon: "h-9 w-9",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+);
+
+export interface ButtonProps
+  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
+    VariantProps<typeof buttonVariants> {
+  asChild?: boolean;
+}
+
+const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant, size, ...props }, ref) => {
+    return (
+      <button
+        className={cn(buttonVariants({ variant, size, className }))}
+        ref={ref}
+        {...props}
+      />
+    );
+  }
+);
+Button.displayName = "Button";
+
+export { Button, buttonVariants };

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/components/ui/card.tsx

@@ -0,0 +1,82 @@
+import * as React from "react";
+import { cn } from "@/lib/utils";
+
+const Card = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn(
+      "rounded-xl border bg-card text-card-foreground shadow",
+      className
+    )}
+    {...props}
+  />
+));
+Card.displayName = "Card";
+
+const CardHeader = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("flex flex-col space-y-1.5 p-6", className)}
+    {...props}
+  />
+));
+CardHeader.displayName = "CardHeader";
+
+const CardTitle = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("font-semibold leading-none tracking-tight", className)}
+    {...props}
+  />
+));
+CardTitle.displayName = "CardTitle";
+
+const CardDescription = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("text-sm text-muted-foreground", className)}
+    {...props}
+  />
+));
+CardDescription.displayName = "CardDescription";
+
+const CardContent = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div ref={ref} className={cn("p-6 pt-0", className)} {...props} />
+));
+CardContent.displayName = "CardContent";
+
+const CardFooter = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("flex items-center p-6 pt-0", className)}
+    {...props}
+  />
+));
+CardFooter.displayName = "CardFooter";
+
+export {
+  Card,
+  CardHeader,
+  CardFooter,
+  CardTitle,
+  CardDescription,
+  CardContent,
+};

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/components/ui/index.ts

@@ -0,0 +1,12 @@
+export { Button, buttonVariants } from "./button";
+export { Input } from "./input";
+export { Label } from "./label";
+export {
+  Card,
+  CardHeader,
+  CardFooter,
+  CardTitle,
+  CardDescription,
+  CardContent,
+} from "./card";
+export { Badge, badgeVariants } from "./badge";

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/components/ui/input.tsx

@@ -0,0 +1,21 @@
+import * as React from "react";
+import { cn } from "@/lib/utils";
+
+const Input = React.forwardRef<HTMLInputElement, React.ComponentProps<"input">>(
+  ({ className, type, ...props }, ref) => {
+    return (
+      <input
+        type={type}
+        className={cn(
+          "flex h-9 w-full rounded-md border border-input bg-transparent px-3 py-1 text-base shadow-sm transition-colors file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+          className
+        )}
+        ref={ref}
+        {...props}
+      />
+    );
+  }
+);
+Input.displayName = "Input";
+
+export { Input };

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/components/ui/label.tsx

@@ -0,0 +1,21 @@
+import * as React from "react";
+import { cn } from "@/lib/utils";
+
+const Label = React.forwardRef<
+  HTMLLabelElement,
+  React.LabelHTMLAttributes<HTMLLabelElement>
+>(({ className, ...props }, ref) => {
+  return (
+    <label
+      ref={ref}
+      className={cn(
+        "text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70",
+        className
+      )}
+      {...props}
+    />
+  );
+});
+Label.displayName = "Label";
+
+export { Label };

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/hooks/index.ts

@@ -0,0 +1,6 @@
+export { useAuth } from "./use-auth";
+export { useWebSocket } from "./use-websocket";
+export { useChat } from "./use-chat";
+{%- if cookiecutter.enable_conversation_persistence and cookiecutter.use_database %}
+export { useConversations } from "./use-conversations";
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/hooks/use-auth.ts

@@ -0,0 +1,97 @@
+"use client";
+
+import { useCallback, useEffect } from "react";
+import { useRouter } from "next/navigation";
+import { useAuthStore } from "@/stores";
+import { apiClient, ApiError } from "@/lib/api-client";
+import type { User, LoginRequest, RegisterRequest } from "@/types";
+import { ROUTES } from "@/lib/constants";
+
+export function useAuth() {
+  const router = useRouter();
+  const { user, isAuthenticated, isLoading, setUser, setLoading, logout } =
+    useAuthStore();
+
+  // Check auth status on mount
+  useEffect(() => {
+    const checkAuth = async () => {
+      try {
+        const userData = await apiClient.get<User>("/auth/me");
+        setUser(userData);
+      } catch {
+        setUser(null);
+      }
+    };
+
+    if (isLoading) {
+      checkAuth();
+    }
+  }, [isLoading, setUser]);
+
+  const login = useCallback(
+    async (credentials: LoginRequest) => {
+      setLoading(true);
+      try {
+        const response = await apiClient.post<{ user: User; message: string }>(
+          "/auth/login",
+          credentials
+        );
+        setUser(response.user);
+        router.push(ROUTES.DASHBOARD);
+        return response;
+      } catch (error) {
+        setLoading(false);
+        throw error;
+      }
+    },
+    [router, setUser, setLoading]
+  );
+
+  const register = useCallback(
+    async (data: RegisterRequest) => {
+      const response = await apiClient.post<{ id: string; email: string }>(
+        "/auth/register",
+        data
+      );
+      return response;
+    },
+    []
+  );
+
+  const handleLogout = useCallback(async () => {
+    try {
+      await apiClient.post("/auth/logout");
+    } catch {
+      // Ignore logout errors
+    } finally {
+      logout();
+      router.push(ROUTES.LOGIN);
+    }
+  }, [logout, router]);
+
+  const refreshToken = useCallback(async () => {
+    try {
+      await apiClient.post("/auth/refresh");
+      // Re-fetch user after token refresh
+      const userData = await apiClient.get<User>("/auth/me");
+      setUser(userData);
+      return true;
+    } catch (error) {
+      if (error instanceof ApiError && error.status === 401) {
+        logout();
+        router.push(ROUTES.LOGIN);
+      }
+      return false;
+    }
+  }, [logout, router, setUser]);
+
+  return {
+    user,
+    isAuthenticated,
+    isLoading,
+    login,
+    register,
+    logout: handleLogout,
+    refreshToken,
+  };
+}