CLAUDE.md

Quick reference for Claude Code when working on prompts.chat

Project Overview

prompts.chat is a social platform for AI prompts built with Next.js 16 App Router, React 19, TypeScript, and PostgreSQL/Prisma. It allows users to share, discover, and collect prompts.

For detailed agent guidelines, see AGENTS.md.

Quick Commands

# Development
npm run dev              # Start dev server at localhost:3000
npm run build            # Production build (runs prisma generate)
npm run lint             # Run ESLint

# Database
npm run db:migrate       # Run Prisma migrations
npm run db:push          # Push schema changes
npm run db:studio        # Open Prisma Studio
npm run db:seed          # Seed database

# Type checking
npx tsc --noEmit         # Check TypeScript types

Key Files

File	Purpose
`prompts.config.ts`	Main app configuration (branding, theme, auth, features)
`prisma/schema.prisma`	Database schema
`src/lib/auth/index.ts`	NextAuth configuration
`src/lib/db.ts`	Prisma client singleton
`messages/*.json`	i18n translation files

Project Structure

src/
├── app/              # Next.js App Router pages
│   ├── (auth)/       # Login, register
│   ├── api/          # API routes
│   ├── prompts/      # Prompt CRUD pages
│   └── admin/        # Admin dashboard
├── components/       # React components
│   ├── ui/           # shadcn/ui base components
│   └── prompts/      # Prompt-related components
└── lib/              # Utilities and config
    ├── ai/           # OpenAI integration
    ├── auth/         # NextAuth setup
    └── plugins/      # Auth and storage plugins

Code Patterns

Server Components by default,
```
"use client"
```
only when needed
Translations: Use
```
useTranslations()
```
or
```
getTranslations()
```
from next-intl
Styling: Tailwind CSS with
```
cn()
```
utility for conditional classes
Forms: React Hook Form + Zod validation
Database: Prisma client from
```
@/lib/db
```

Before Committing

Run
```
npm run lint
```
to check for issues
Add translations for any user-facing text
Use existing UI components from
```
src/components/ui/
```
Never commit secrets (use
```
.env
```
)

Quick Commands

# Development
npm run dev              # Start dev server at localhost:3000
npm run build            # Production build (runs prisma generate)
npm run lint             # Run ESLint

# Database
npm run db:migrate       # Run Prisma migrations
npm run db:push          # Push schema changes
npm run db:studio        # Open Prisma Studio
npm run db:seed          # Seed database

# Type checking
npx tsc --noEmit         # Check TypeScript types

File

Purpose

prompts.config.ts

Main app configuration (branding, theme, auth, features)

prisma/schema.prisma

Database schema

src/lib/auth/index.ts

NextAuth configuration

src/lib/db.ts

Prisma client singleton

messages/*.json

i18n translation files

Project Structure

src/
├── app/              # Next.js App Router pages
│   ├── (auth)/       # Login, register
│   ├── api/          # API routes
│   ├── prompts/      # Prompt CRUD pages
│   └── admin/        # Admin dashboard
├── components/       # React components
│   ├── ui/           # shadcn/ui base components
│   └── prompts/      # Prompt-related components
└── lib/              # Utilities and config
    ├── ai/           # OpenAI integration
    ├── auth/         # NextAuth setup
    └── plugins/      # Auth and storage plugins

CLAUDE.md

CLAUDE.md

Project Overview

Quick Commands

Key Files

Project Structure

Code Patterns

Before Committing

Related Skills

<h1 align="center">

- Identify gaps

2. Apply Deepthink Protocol (reason about dependencies

CLAUDE.md

Project Overview

Quick Commands

Key Files

Project Structure

Code Patterns

Before Committing