nextjs-hackathon-stack 0.1.11 → 0.1.13

package/README.md

@@ -20,7 +20,7 @@ npx nextjs-hackathon-stack my-app
 | Forms | React Hook Form + Zod resolver |
 | UI | shadcn/ui + Tailwind CSS v4 |
 | AI Streaming | Vercel AI SDK + AI Gateway |
-| LLM | MiniMax M2.7 (`minimax/minimax-m2.7`) |
+| LLM | Google Gemini 2.0 Flash (`google/gemini-2.0-flash`) |
 | Testing | Vitest + React Testing Library + Playwright |
 
 ## Quick start
@@ -34,7 +34,6 @@ cd my-app
 #   NEXT_PUBLIC_SUPABASE_URL      → supabase.com > Project Settings > API
 #   NEXT_PUBLIC_SUPABASE_ANON_KEY → supabase.com > Project Settings > API
 #   DATABASE_URL                  → supabase.com > Project Settings > Database
-#   MINIMAX_API_KEY               → minimaxi.chat > API Keys
 #   AI_GATEWAY_URL                → vercel.com > AI > Gateways
 
 npm run dev
@@ -53,9 +52,7 @@ npx nextjs-hackathon-stack my-app --skip-install
 ## Features
 
 - **Auth** — Email/password login with Supabase Auth, Server Actions, protected routes
-- **AI Chat** — Streaming chat with MiniMax M2.7 via Vercel AI Gateway (Edge runtime)
-- **Video Generation** — MiniMax Video-01 via direct API
-- **Text-to-Speech** — MiniMax Speech 2.6 via direct API
+- **AI Chat** — Streaming chat with Gemini 2.0 Flash via Vercel AI Gateway (Edge runtime)
 - **TDD-ready** — 100% coverage enforced, Vitest + Playwright preconfigured
 - **Cursor AI** — Rules, agents, and skills preconfigured for the full stack
 
@@ -68,11 +65,9 @@ src/
 ├── app/           # Next.js routing + layouts
 ├── features/
 │   ├── auth/      # Login form, server actions, session hook
-│   ├── chat/      # AI chat (streaming)
-│   ├── video/     # Video generation
-│   └── tts/       # Text-to-speech
+│   └── chat/      # AI chat (streaming)
 ├── shared/
-│   ├── lib/       # Supabase clients, AI, MiniMax
+│   ├── lib/       # Supabase clients, AI
 │   ├── db/        # Drizzle schema + migrations
 │   └── components/# Providers + shadcn/ui
 └── e2e/           # Playwright e2e tests

package/dist/index.js

@@ -112,6 +112,13 @@ async function scaffold(projectName, skipInstall) {
       p3.log.error(stderr || "pnpm install failed");
       p3.log.info("You can install manually: cd " + projectName + " && pnpm install");
     }
+    spinner2.start("Setting up husky pre-commit hooks");
+    try {
+      execSync("pnpm exec husky", { cwd: targetDir, stdio: "pipe" });
+      spinner2.stop("Husky pre-commit hooks set up");
+    } catch {
+      spinner2.stop("Husky setup failed \u2014 run manually: pnpm exec husky");
+    }
     spinner2.start("Initializing shadcn/ui");
     try {
       execSync("npx shadcn@latest init --yes --defaults --force --silent", {
@@ -152,8 +159,7 @@ async function scaffold(projectName, skipInstall) {
   console.log(`    ${pc2.dim("NEXT_PUBLIC_SUPABASE_URL")}       \u2014 from supabase.com > Project Settings > API`);
   console.log(`    ${pc2.dim("NEXT_PUBLIC_SUPABASE_ANON_KEY")}  \u2014 from supabase.com > Project Settings > API`);
   console.log(`    ${pc2.dim("DATABASE_URL")}                   \u2014 from supabase.com > Project Settings > Database`);
-  console.log(`    ${pc2.dim("AI_GATEWAY_URL")}                 \u2014 Vercel AI Gateway URL`);
-  console.log(`    ${pc2.dim("MINIMAX_API_KEY")}                \u2014 from minimaxi.chat`);
+  console.log(`    ${pc2.dim("AI_GATEWAY_URL")}                 \u2014 from vercel.com > AI > Gateways`);
   console.log(`  ${pc2.cyan("pnpm dev")}
 `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextjs-hackathon-stack",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Scaffold a full-stack Next.js hackathon starter",
   "type": "module",
   "bin": {
@@ -22,7 +22,7 @@
     "drizzle",
     "tanstack-query",
     "shadcn",
-    "minimax",
+    "gemini",
     "starter"
   ],
   "repository": {

package/template/.cursor/rules/ai.mdc

@@ -1,6 +1,6 @@
 ---
 description: AI SDK + Edge runtime rules. RISK 3 (cold starts).
-globs: ["src/features/chat/**", "src/features/video/**", "src/features/tts/**", "src/shared/lib/ai*"]
+globs: ["src/features/chat/**", "src/shared/lib/ai*"]
 ---
 
 # AI Rules (Risk 3: Vercel Cold Starts)
@@ -30,12 +30,12 @@ If you need DB data in an AI route:
 ```typescript
 import { createOpenAI } from "@ai-sdk/openai";
 
-const gateway = createOpenAI({
+const provider = createOpenAI({
   baseURL: process.env.AI_GATEWAY_URL,
-  apiKey: process.env.MINIMAX_API_KEY,
+  apiKey: process.env.AI_API_KEY,
 });
 
-export const aiModel = gateway("MiniMax-Text-01");
+export const aiModel = provider(process.env.AI_MODEL ?? "google/gemini-2.0-flash");
 ```
 
 ## Streaming Pattern

package/template/.cursor/rules/general.mdc

@@ -15,14 +15,14 @@ alwaysApply: true
 - **Validation**: Zod (auto-generated via `drizzle-zod`)
 - **Forms**: React Hook Form + Zod resolver
 - **UI**: shadcn/ui + Tailwind CSS v4
-- **AI**: Vercel AI SDK + MiniMax M2.7 via AI Gateway
+- **AI**: Vercel AI SDK + Google Gemini 2.0 Flash via AI Gateway
 - **Testing**: Vitest + React Testing Library + Playwright
 
 ## Project Structure
 ```
 src/
 ├── app/               # Next.js App Router pages
-├── features/          # Feature modules (auth, chat, video, tts)
+├── features/          # Feature modules (auth, chat)
 │   └── <feature>/
 │       ├── components/
 │       ├── actions/

package/template/.husky/pre-commit

@@ -0,0 +1 @@
+vitest run --coverage

package/template/README.md

@@ -14,7 +14,7 @@ Full-stack Next.js 15 hackathon starter.
 | State | TanStack Query v5 |
 | Forms | React Hook Form + Zod |
 | UI | shadcn/ui + Tailwind CSS v4 |
-| AI | Vercel AI SDK + MiniMax |
+| AI | Vercel AI SDK + Gemini 2.0 Flash |
 | Testing | Vitest + Playwright |
 
 ## Getting Started
@@ -29,11 +29,10 @@ NEXT_PUBLIC_SUPABASE_URL=https://your-project-id.supabase.co
 NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
 DATABASE_URL=postgresql://postgres:[password]@db.your-project-id.supabase.co:5432/postgres
 
-# MiniMax — https://www.minimaxi.chat > API Keys
-MINIMAX_API_KEY=your-minimax-api-key
-
-# Vercel AI Gateway — https://vercel.com > AI > Gateways
+# AI — Vercel AI Gateway (default: Google Gemini 2.0 Flash — free tier)
+# Create gateway at: https://vercel.com > AI > Gateways
 AI_GATEWAY_URL=https://gateway.ai.vercel.app/v1/your-team-id/your-gateway-id
+AI_API_KEY=
 ```
 
 ### 2. Run the dev server
@@ -70,8 +69,8 @@ pnpm db:migrate      # Apply migrations
 | `NEXT_PUBLIC_SUPABASE_URL` | Supabase > Project Settings > API |
 | `NEXT_PUBLIC_SUPABASE_ANON_KEY` | Supabase > Project Settings > API |
 | `DATABASE_URL` | Supabase > Project Settings > Database > URI |
-| `MINIMAX_API_KEY` | minimaxi.chat > API Keys |
 | `AI_GATEWAY_URL` | Vercel > AI > Gateways |
+| `AI_API_KEY` | Your AI provider API key |
 | `NEXT_PUBLIC_APP_URL` | Your deployment URL (default: `http://localhost:3000`) |
 
 See `.env.example` for all required variables with comments.
@@ -82,7 +81,7 @@ Feature-based structure:
 ```
 src/
 ├── app/           # Next.js routing + layouts
-├── features/      # auth | chat | video | tts
+├── features/      # auth | chat
 ├── shared/        # lib | db | components/ui
 └── e2e/           # Playwright tests
 ```

package/template/_env.example

@@ -9,13 +9,13 @@ NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
 # Supabase DB — https://supabase.com > Project Settings > Database > Connection string (URI)
 DATABASE_URL=postgresql://postgres:[password]@db.your-project-id.supabase.co:5432/postgres
 
-# AI Provider — defaults to MiniMax direct API
-AI_API_KEY=your-api-key
-# Optional: override base URL (default: https://api.minimaxi.chat/v1)
-# For Vercel Gateway: https://ai-gateway.vercel.sh/v1
-# AI_BASE_URL=https://api.minimaxi.chat/v1
-# Optional: override model (default: MiniMax-M1)
-# AI_MODEL=MiniMax-M1
+# AI — Vercel AI Gateway (default: Google Gemini 2.0 Flash — free tier)
+# Create gateway at: https://vercel.com > AI > Gateways
+AI_GATEWAY_URL=https://gateway.ai.vercel.app/v1/your-team-id/your-gateway-id
+AI_API_KEY=
+# Optional: override model (default: google/gemini-2.0-flash)
+# To use MiniMax: AI_MODEL=minimax/minimax-m2.7
+# AI_MODEL=google/gemini-2.0-flash
 
 # =============================================================================
 # OPTIONAL

package/template/package.json.tmpl

@@ -16,7 +16,8 @@
     "test:e2e": "playwright test",
     "db:generate": "drizzle-kit generate",
     "db:migrate": "drizzle-kit migrate",
-    "db:studio": "drizzle-kit studio"
+    "db:studio": "drizzle-kit studio",
+    "prepare": "husky"
   },
   "dependencies": {
     "next": "^15",
@@ -64,6 +65,11 @@
     "eslint-plugin-react-hooks": "^5",
     "eslint-plugin-import-x": "^4",
     "eslint-plugin-vitest": "^0.5",
-    "eslint-plugin-playwright": "^2"
+    "eslint-plugin-playwright": "^2",
+    "husky": "^9",
+    "lint-staged": "^15"
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": ["vitest related --run"]
   }
 }

package/template/src/app/__tests__/auth-callback.test.ts

@@ -0,0 +1,72 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+
+const mockExchangeCodeForSession = vi.fn();
+
+vi.mock("@/shared/lib/supabase/server", () => ({
+  createClient: vi.fn(() =>
+    Promise.resolve({
+      auth: { exchangeCodeForSession: mockExchangeCodeForSession },
+    })
+  ),
+}));
+
+describe("auth callback route", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("redirects to /login with error when code is missing", async () => {
+    // Arrange
+    const { GET } = await import("../api/auth/callback/route");
+    const req = new Request("http://localhost/api/auth/callback");
+
+    // Act
+    const response = await GET(req);
+
+    // Assert
+    expect(response.status).toBe(307);
+    expect(response.headers.get("location")).toContain("/login?error=no_code");
+  });
+
+  it("redirects to /login with error when exchange fails", async () => {
+    // Arrange
+    mockExchangeCodeForSession.mockResolvedValue({ error: { message: "bad code" } });
+    const { GET } = await import("../api/auth/callback/route");
+    const req = new Request("http://localhost/api/auth/callback?code=bad-code");
+
+    // Act
+    const response = await GET(req);
+
+    // Assert
+    expect(response.status).toBe(307);
+    expect(response.headers.get("location")).toContain("/login?error=auth_error");
+  });
+
+  it("redirects to / on successful exchange", async () => {
+    // Arrange
+    mockExchangeCodeForSession.mockResolvedValue({ error: null });
+    const { GET } = await import("../api/auth/callback/route");
+    const req = new Request("http://localhost/api/auth/callback?code=valid-code");
+
+    // Act
+    const response = await GET(req);
+
+    // Assert
+    expect(response.status).toBe(307);
+    expect(response.headers.get("location")).toBe("http://localhost/");
+  });
+
+  it("redirects to next param on successful exchange", async () => {
+    // Arrange
+    mockExchangeCodeForSession.mockResolvedValue({ error: null });
+    const { GET } = await import("../api/auth/callback/route");
+    const req = new Request("http://localhost/api/auth/callback?code=valid-code&next=/dashboard");
+
+    // Act
+    const response = await GET(req);
+
+    // Assert
+    expect(response.status).toBe(307);
+    expect(response.headers.get("location")).toContain("/dashboard");
+  });
+});

package/template/src/app/__tests__/error.test.tsx

@@ -0,0 +1,71 @@
+import { render, screen } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { describe, it, expect, vi } from "vitest";
+
+import ErrorPage from "../error";
+
+describe("ErrorPage", () => {
+  it("renders error heading", () => {
+    // Arrange
+    const error = new Error("Something failed");
+    const reset = vi.fn();
+
+    // Act
+    render(<ErrorPage error={error} reset={reset} />);
+
+    // Assert
+    expect(screen.getByText(/something went wrong/i)).toBeInTheDocument();
+  });
+
+  it("renders error message", () => {
+    // Arrange
+    const error = new Error("Specific error message");
+    const reset = vi.fn();
+
+    // Act
+    render(<ErrorPage error={error} reset={reset} />);
+
+    // Assert
+    expect(screen.getByText("Specific error message")).toBeInTheDocument();
+  });
+
+  it("renders Try again button", () => {
+    // Arrange
+    const error = new Error("test");
+    const reset = vi.fn();
+
+    // Act
+    render(<ErrorPage error={error} reset={reset} />);
+
+    // Assert
+    expect(screen.getByRole("button", { name: /try again/i })).toBeInTheDocument();
+  });
+
+  it("calls reset when Try again is clicked", async () => {
+    // Arrange
+    const error = new Error("test");
+    const reset = vi.fn();
+    const user = userEvent.setup();
+    render(<ErrorPage error={error} reset={reset} />);
+
+    // Act
+    await user.click(screen.getByRole("button", { name: /try again/i }));
+
+    // Assert
+    expect(reset).toHaveBeenCalledOnce();
+  });
+
+  it("logs error to console on mount", () => {
+    // Arrange
+    const error = new Error("logged error");
+    const reset = vi.fn();
+    const consoleSpy = vi.spyOn(console, "error").mockImplementation(() => undefined);
+
+    // Act
+    render(<ErrorPage error={error} reset={reset} />);
+
+    // Assert
+    expect(consoleSpy).toHaveBeenCalledWith(error);
+    consoleSpy.mockRestore();
+  });
+});

package/template/src/app/__tests__/layout.test.tsx

@@ -0,0 +1,22 @@
+import { render } from "@testing-library/react";
+import { describe, it, expect, vi } from "vitest";
+
+import RootLayout from "../layout";
+
+vi.mock("@/shared/components/providers", () => ({
+  Providers: ({ children }: { children: React.ReactNode }) => <div>{children}</div>,
+}));
+
+describe("RootLayout", () => {
+  it("renders children inside body", () => {
+    // Arrange + Act
+    const { container } = render(
+      <RootLayout>
+        <p data-testid="child-content">Hello</p>
+      </RootLayout>
+    );
+
+    // Assert
+    expect(container.querySelector("[data-testid='child-content']")).toBeTruthy();
+  });
+});

package/template/src/app/__tests__/login-page.test.tsx

@@ -0,0 +1,34 @@
+import { render, screen } from "@testing-library/react";
+import { describe, it, expect, vi } from "vitest";
+
+import LoginPage from "../(auth)/login/page";
+
+vi.mock("@/features/auth/components/login-form", () => ({
+  LoginForm: () => <div data-testid="login-form" />,
+}));
+
+describe("LoginPage", () => {
+  it("renders the welcome heading", () => {
+    // Arrange + Act
+    render(<LoginPage />);
+
+    // Assert
+    expect(screen.getByText(/welcome back/i)).toBeInTheDocument();
+  });
+
+  it("renders the LoginForm component", () => {
+    // Arrange + Act
+    render(<LoginPage />);
+
+    // Assert
+    expect(screen.getByTestId("login-form")).toBeInTheDocument();
+  });
+
+  it("renders the sign-in description", () => {
+    // Arrange + Act
+    render(<LoginPage />);
+
+    // Assert
+    expect(screen.getByText(/sign in to your account/i)).toBeInTheDocument();
+  });
+});

package/template/src/app/__tests__/protected-layout.test.tsx

@@ -0,0 +1,43 @@
+import { describe, it, expect, vi } from "vitest";
+
+const mockGetUser = vi.fn();
+const mockRedirect = vi.fn();
+
+vi.mock("@/shared/lib/supabase/server", () => ({
+  createClient: vi.fn(() =>
+    Promise.resolve({
+      auth: { getUser: mockGetUser },
+    })
+  ),
+}));
+
+vi.mock("next/navigation", () => ({
+  redirect: (url: string) => mockRedirect(url),
+}));
+
+describe("ProtectedLayout", () => {
+  it("renders children when user is authenticated", async () => {
+    // Arrange
+    mockGetUser.mockResolvedValue({ data: { user: { email: "user@example.com" } } });
+    const { default: ProtectedLayout } = await import("../(protected)/layout");
+
+    // Act
+    const result = await ProtectedLayout({ children: <div data-testid="child" /> });
+
+    // Assert
+    expect(result).toBeTruthy();
+    expect(mockRedirect).not.toHaveBeenCalled();
+  });
+
+  it("redirects to /login when user is not authenticated", async () => {
+    // Arrange
+    mockGetUser.mockResolvedValue({ data: { user: null } });
+    const { default: ProtectedLayout } = await import("../(protected)/layout");
+
+    // Act
+    await ProtectedLayout({ children: <div /> });
+
+    // Assert
+    expect(mockRedirect).toHaveBeenCalledWith("/login");
+  });
+});

package/template/src/app/__tests__/protected-page.test.tsx

@@ -0,0 +1,41 @@
+import { describe, it, expect, vi } from "vitest";
+
+const mockGetUser = vi.fn();
+
+vi.mock("@/shared/lib/supabase/server", () => ({
+  createClient: vi.fn(() =>
+    Promise.resolve({
+      auth: { getUser: mockGetUser },
+    })
+  ),
+}));
+
+vi.mock("@/features/chat/components/chat-ui", () => ({
+  ChatUi: () => <div data-testid="chat-ui" />,
+}));
+
+describe("HomePage (protected)", () => {
+  it("renders welcome message with user email", async () => {
+    // Arrange
+    mockGetUser.mockResolvedValue({ data: { user: { email: "user@example.com" } } });
+    const { default: HomePage } = await import("../(protected)/page");
+
+    // Act
+    const result = await HomePage();
+
+    // Assert
+    expect(result).toBeTruthy();
+  });
+
+  it("renders with null user gracefully", async () => {
+    // Arrange
+    mockGetUser.mockResolvedValue({ data: { user: null } });
+    const { default: HomePage } = await import("../(protected)/page");
+
+    // Act
+    const result = await HomePage();
+
+    // Assert
+    expect(result).toBeTruthy();
+  });
+});

package/template/src/app/api/chat/route.ts

@@ -16,7 +16,9 @@ export async function POST(req: Request) {
   return result.toDataStreamResponse({
     getErrorMessage: (error) => {
       console.error("[chat] stream error:", error);
-      return error instanceof Error ? error.message : "AI request failed";
+      if (error instanceof Error) return error.message;
+      if (typeof error === "object" && error !== null) return JSON.stringify(error);
+      return String(error);
     },
   });
 }

package/template/src/features/auth/__tests__/login-form.test.tsx

@@ -1,16 +1,19 @@
-import { render, screen } from "@testing-library/react";
+import { render, screen, waitFor } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { describe, it, expect, vi, beforeEach } from "vitest";
 
 import { LoginForm } from "../components/login-form";
 
+const mockLoginAction = vi.fn().mockResolvedValue({ status: "idle" });
+
 vi.mock("../actions/login.action", () => ({
-  loginAction: vi.fn().mockResolvedValue({ status: "idle" }),
+  loginAction: (...args: unknown[]) => mockLoginAction(...args),
 }));
 
 describe("LoginForm", () => {
   beforeEach(() => {
     vi.clearAllMocks();
+    mockLoginAction.mockResolvedValue({ status: "idle" });
   });
 
   it("renders email and password fields", () => {
@@ -41,4 +44,52 @@ describe("LoginForm", () => {
     // Assert
     expect(await screen.findByText(/invalid email/i)).toBeInTheDocument();
   });
+
+  it("shows validation error for short password", async () => {
+    // Arrange
+    const user = userEvent.setup();
+    render(<LoginForm />);
+
+    // Act
+    await user.type(screen.getByLabelText(/email/i), "user@example.com");
+    await user.type(screen.getByLabelText(/password/i), "short");
+    await user.click(screen.getByRole("button", { name: /sign in/i }));
+
+    // Assert
+    expect(await screen.findByText(/at least 8 characters/i)).toBeInTheDocument();
+  });
+
+  it("submits with valid credentials and calls loginAction", async () => {
+    // Arrange
+    const user = userEvent.setup();
+    render(<LoginForm />);
+
+    // Act
+    await user.type(screen.getByLabelText(/email/i), "user@example.com");
+    await user.type(screen.getByLabelText(/password/i), "password123");
+    await user.click(screen.getByRole("button", { name: /sign in/i }));
+
+    // Assert
+    await waitFor(() => {
+      expect(mockLoginAction).toHaveBeenCalled();
+    });
+  });
+
+  it("displays server-side error message when action returns error", async () => {
+    // Arrange
+    mockLoginAction.mockResolvedValue({ status: "error", message: "Invalid credentials" });
+    const user = userEvent.setup();
+    render(<LoginForm />);
+
+    // Act
+    await user.type(screen.getByLabelText(/email/i), "user@example.com");
+    await user.type(screen.getByLabelText(/password/i), "password123");
+    await user.click(screen.getByRole("button", { name: /sign in/i }));
+
+    // Assert
+    await waitFor(() => {
+      expect(screen.getByRole("alert")).toBeInTheDocument();
+      expect(screen.getByText(/invalid credentials/i)).toBeInTheDocument();
+    });
+  });
 });