Skip to content

CLAUDE.md

Latest commit

 

History

History
49 lines (31 loc) · 1.97 KB

CLAUDE.md

File metadata and controls

49 lines (31 loc) · 1.97 KB

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Next.js 16 app using Vercel AI SDK for building AI chat interfaces. Supports multiple AI providers (OpenAI, Google) with streaming responses. Uses shadcn/ui for component library.

Development Commands

npm run dev    # Start dev server on localhost:3000
npm run build  # Production build
npm run lint   # Run ESLint
npm start      # Start production server

Architecture

API Route Pattern: Chat endpoint at app/api/chat/route.ts uses AI SDK's streamText() with convertToModelMessages() for message format conversion. Returns toUIMessageStreamResponse() for streaming.

Client Component: components/chat.tsx uses useChat() hook from @ai-sdk/react. Messages have .parts array with type-based rendering (currently only 'text' type handled).

AI Provider: Chat uses OpenAI GPT-4o. Image generation uses Google Gemini 2.5 Flash. Providers swappable via @ai-sdk/{provider} imports.

Path Aliases: Uses @/* for root-level imports (configured in tsconfig.json).

Image Generation: app/api/image/route.ts uses generateText() with google('gemini-2.5-flash-image-preview') model. Two modes:

  • Text-to-image: Simple prompt input
  • Image editing: Multimodal format with base64 image + prompt

Returns images extracted from result.files as base64 data URIs. Client component at components/image-generator.tsx uses Dropzone for uploads.

shadcn/ui

Configured with "new-york" style and CSS variables. Components use Lucide icons.

Add components via: npx shadcn@latest add [component-name]

Component aliases:

  • @/components - Base components directory
  • @/components/ui - shadcn UI components
  • @/lib/utils - Utility functions (includes cn() for class merging)

Environment

Requires .env.local with API keys:

  • OPENAI_API_KEY - For chat functionality
  • GOOGLE_GENERATIVE_AI_API_KEY - For image generation