Project Overview and Technical Specification

Project Details

Project Name

• prompts.chat — a full-stack social platform for collaborative AI prompts

Evolution

• The project is an evolution of the "Awesome ChatGPT Prompts" GitHub repository, expanded into a comprehensive social platform

Package Manager

• Primary package manager: npm (not pnpm or yarn)

Technical Architecture and Libraries

Programming Language and Version

• Language: TypeScript 5
• Mode: Strict mode enabled

Frontend Framework

• Core framework: Next.js App Router
• Component architecture:
  • Use React Server Components by default for all non-interactive components
  • Add "use client" directive only for interactive components requiring client-side rendering
• Styling library:
  • Tailwind CSS 4
  • Radix UI
  • shadcn/ui (composable UI components)
  • Class merging utility: cn()

Database and ORM

• Database: PostgreSQL
• ORM: Prisma
• Connection: Singleton instance at src/lib/db.ts
• Deletion strategy:
  • Soft deletes using deletedAt field for Prompt and Comment models
  • Never perform hard deletion on these records

API and Schema Validation

• Schema validation: Zod schemas for all API input validation
• Number of API routes:
  • 61 API routes under src/app/api/
  • Main ChatGPT model server at src/pages/api/mcp.ts

Internationalization (i18n)

• Library: next-intl
• Client-side usage: useTranslations()
• Server-side usage: getTranslations()
• Supported locales: 17 locales with RTL support for Arabic, Hebrew, and Farsi

GitHub Actions Workflows

Version Requirements

• Checkout action: actions/checkout@v6
• Node.js setup action: actions/setup-node@v6 (not v4)
• Node.js version: Node.js version 24 (not 20)

Plugin Architecture

• Integration pattern: Plugin registry
• Integrated plugins: Auth, storage, media generator

Cache Invalidation

• Cache invalidation method: revalidateTag() after mutations

Please ensure all instructions and requirements are followed accurately to maintain the project's structural integrity and performance.