Quick reference for Claude Code when working on prompts.chat
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.
# 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 |
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
- Server Components by default,
"use client"only when needed - Translations: Use
useTranslations()orgetTranslations()from next-intl - Styling: Tailwind CSS with
cn()utility for conditional classes - Forms: React Hook Form + Zod validation
- Database: Prisma client from
@/lib/db
- Run
npm run lintto check for issues - Add translations for any user-facing text
- Use existing UI components from
src/components/ui/ - Never commit secrets (use
.env)