fastapi-fullstack 0.1.7__py3-none-any.whl

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/components/language-switcher.tsx

@@ -0,0 +1,97 @@
+{%- if cookiecutter.enable_i18n %}
+'use client';
+
+import { useLocale } from 'next-intl';
+import { useRouter, usePathname } from 'next/navigation';
+import { locales, type Locale, getLocaleLabel } from '@/i18n';
+
+/**
+ * Language switcher dropdown component.
+ * Allows users to switch between available locales.
+ */
+export function LanguageSwitcher() {
+  const locale = useLocale();
+  const router = useRouter();
+  const pathname = usePathname();
+
+  const handleChange = (newLocale: Locale) => {
+    // Remove the current locale from pathname and add the new one
+    const segments = pathname.split('/');
+    segments[1] = newLocale;
+    const newPath = segments.join('/');
+    router.push(newPath);
+  };
+
+  return (
+    <div className="relative">
+      <select
+        value={locale}
+        onChange={(e) => handleChange(e.target.value as Locale)}
+        className="appearance-none bg-transparent border border-gray-300 dark:border-gray-600 rounded-md px-3 py-1.5 pr-8 text-sm cursor-pointer hover:border-gray-400 dark:hover:border-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500"
+        aria-label="Select language"
+      >
+        {locales.map((loc) => (
+          <option key={loc} value={loc}>
+            {getLocaleLabel(loc)}
+          </option>
+        ))}
+      </select>
+      <div className="pointer-events-none absolute inset-y-0 right-0 flex items-center px-2 text-gray-500">
+        <svg className="h-4 w-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M19 9l-7 7-7-7" />
+        </svg>
+      </div>
+    </div>
+  );
+}
+
+/**
+ * Compact language switcher with flag icons.
+ */
+export function LanguageSwitcherCompact() {
+  const locale = useLocale();
+  const router = useRouter();
+  const pathname = usePathname();
+
+  const flags: Record<Locale, string> = {
+    en: '🇬🇧',
+    pl: '🇵🇱',
+  };
+
+  const handleChange = (newLocale: Locale) => {
+    const segments = pathname.split('/');
+    segments[1] = newLocale;
+    const newPath = segments.join('/');
+    router.push(newPath);
+  };
+
+  return (
+    <div className="flex gap-1">
+      {locales.map((loc) => (
+        <button
+          key={loc}
+          onClick={() => handleChange(loc)}
+          className={`px-2 py-1 rounded-md text-lg transition-opacity ${
+            locale === loc
+              ? 'opacity-100 bg-gray-100 dark:bg-gray-800'
+              : 'opacity-50 hover:opacity-75'
+          }`}
+          aria-label={getLocaleLabel(loc)}
+          aria-pressed={locale === loc}
+        >
+          {flags[loc]}
+        </button>
+      ))}
+    </div>
+  );
+}
+{%- else %}
+// i18n is disabled - no language switcher component
+export function LanguageSwitcher() {
+  return null;
+}
+
+export function LanguageSwitcherCompact() {
+  return null;
+}
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/components/layout/header.tsx

@@ -0,0 +1,65 @@
+"use client";
+
+import Link from "next/link";
+import { useAuth } from "@/hooks";
+import { Button } from "@/components/ui";
+import { ThemeToggle } from "@/components/theme";
+{%- if cookiecutter.enable_i18n %}
+import { LanguageSwitcherCompact } from "@/components/language-switcher";
+{%- endif %}
+import { ROUTES } from "@/lib/constants";
+import { LogOut, User, Menu } from "lucide-react";
+import { useSidebarStore } from "@/stores";
+
+export function Header() {
+  const { user, isAuthenticated, logout } = useAuth();
+  const { toggle } = useSidebarStore();
+
+  return (
+    <header className="sticky top-0 z-40 w-full border-b bg-background/95 backdrop-blur supports-[backdrop-filter]:bg-background/60">
+      <div className="flex h-14 items-center justify-between px-3 sm:px-6">
+        <Button
+          variant="ghost"
+          size="sm"
+          className="h-10 w-10 p-0 md:hidden"
+          onClick={toggle}
+        >
+          <Menu className="h-5 w-5" />
+          <span className="sr-only">Toggle menu</span>
+        </Button>
+
+        <div className="hidden md:block" />
+
+        <div className="flex items-center gap-2 sm:gap-3">
+{%- if cookiecutter.enable_i18n %}
+          <LanguageSwitcherCompact />
+{%- endif %}
+          <ThemeToggle />
+          {isAuthenticated ? (
+            <>
+              <Button variant="ghost" size="sm" asChild className="h-10 px-2 sm:px-3">
+                <Link href={ROUTES.PROFILE} className="flex items-center gap-2">
+                  <User className="h-4 w-4" />
+                  <span className="hidden max-w-32 truncate sm:inline">{user?.email}</span>
+                </Link>
+              </Button>
+              <Button variant="ghost" size="sm" onClick={logout} className="h-10 w-10 p-0 sm:w-auto sm:px-3">
+                <LogOut className="h-4 w-4" />
+                <span className="sr-only sm:not-sr-only sm:ml-2">Logout</span>
+              </Button>
+            </>
+          ) : (
+            <>
+              <Button variant="ghost" size="sm" asChild className="h-10">
+                <Link href={ROUTES.LOGIN}>Login</Link>
+              </Button>
+              <Button size="sm" asChild className="h-10">
+                <Link href={ROUTES.REGISTER}>Register</Link>
+              </Button>
+            </>
+          )}
+        </div>
+      </div>
+    </header>
+  );
+}

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

@@ -0,0 +1,2 @@
+export { Header } from "./header";
+export { Sidebar } from "./sidebar";

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/components/layout/sidebar.tsx

@@ -0,0 +1,82 @@
+"use client";
+
+import Link from "next/link";
+import { usePathname } from "next/navigation";
+import { cn } from "@/lib/utils";
+import { ROUTES } from "@/lib/constants";
+import { LayoutDashboard, MessageSquare } from "lucide-react";
+import { useSidebarStore } from "@/stores";
+import { Sheet, SheetContent, SheetHeader, SheetTitle, SheetClose } from "@/components/ui";
+
+const navigation = [
+  { name: "Dashboard", href: ROUTES.DASHBOARD, icon: LayoutDashboard },
+  { name: "Chat", href: ROUTES.CHAT, icon: MessageSquare },
+];
+
+function NavLinks({ onNavigate }: { onNavigate?: () => void }) {
+  const pathname = usePathname();
+
+  return (
+    <nav className="flex-1 space-y-1 p-4">
+      {navigation.map((item) => {
+        const isActive = pathname === item.href;
+        return (
+          <Link
+            key={item.name}
+            href={item.href}
+            onClick={onNavigate}
+            className={cn(
+              "flex items-center gap-3 rounded-lg px-3 py-3 text-sm font-medium transition-colors",
+              "min-h-[44px]",
+              isActive
+                ? "bg-secondary text-secondary-foreground"
+                : "text-muted-foreground hover:bg-secondary/50 hover:text-secondary-foreground"
+            )}
+          >
+            <item.icon className="h-5 w-5" />
+            {item.name}
+          </Link>
+        );
+      })}
+    </nav>
+  );
+}
+
+function SidebarContent({ onNavigate }: { onNavigate?: () => void }) {
+  return (
+    <div className="flex h-full flex-col">
+      <div className="flex h-14 items-center border-b px-4">
+        <Link
+          href={ROUTES.HOME}
+          className="flex items-center gap-2 font-semibold"
+          onClick={onNavigate}
+        >
+          <span>{"{{ cookiecutter.project_name }}"}</span>
+        </Link>
+      </div>
+      <NavLinks onNavigate={onNavigate} />
+    </div>
+  );
+}
+
+export function Sidebar() {
+  const { isOpen, close } = useSidebarStore();
+
+  return (
+    <>
+      <aside className="hidden w-64 shrink-0 border-r bg-background md:block">
+        <SidebarContent />
+      </aside>
+
+      <Sheet open={isOpen} onOpenChange={close}>
+        <SheetContent side="left" className="w-72 p-0">
+          <SheetHeader className="h-14 px-4">
+            <SheetTitle>{"{{ cookiecutter.project_name }}"}</SheetTitle>
+            <SheetClose onClick={close} />
+          </SheetHeader>
+          <NavLinks onNavigate={close} />
+        </SheetContent>
+      </Sheet>
+    </>
+  );
+}

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

@@ -0,0 +1,7 @@
+{%- if cookiecutter.use_frontend %}
+export { ThemeProvider } from "./theme-provider";
+export { ThemeToggle } from "./theme-toggle";
+{%- else %}
+/* Theme components - frontend not configured */
+export {};
+{%- endif %}

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,105 @@
+{%- if cookiecutter.use_frontend %}
+"use client";
+
+import { useEffect, useState } from "react";
+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 [mounted, setMounted] = useState(false);
+
+  // Prevent hydration mismatch by only rendering after mount
+  useEffect(() => {
+    setMounted(true);
+  }, []);
+
+  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]);
+  };
+
+  // Render placeholder during SSR to prevent hydration mismatch
+  if (!mounted) {
+    return (
+      <Button
+        variant="ghost"
+        size="icon"
+        className={className}
+        aria-label="Toggle theme"
+      >
+        <Sun className="h-5 w-5" />
+      </Button>
+    );
+  }
+
+  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,56 @@
+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, asChild: _asChild, ...props }, ref) => {
+    // Note: asChild is extracted but not used - this component doesn't support Slot rendering
+    // If you need asChild support, install @radix-ui/react-slot and use Slot component
+    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,13 @@
+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";
+export { Sheet, SheetContent, SheetHeader, SheetTitle, SheetClose } from "./sheet";