PDF Editor

A modern web application built with Next.js, featuring authentication, database management with Prisma, and a beautiful UI with Tailwind CSS.

🚀 Tech Stack

• Framework: Next.js 15.5.5 with Turbopack
• Language: TypeScript
• Styling: Tailwind CSS 4
• Database: Prisma ORM with PostgreSQL
• Authentication: NextAuth.js
• State Management: TanStack React Query
• Package Manager: pnpm

📋 Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (v18 or higher)
• pnpm package manager
• PostgreSQL database (or Supabase account)

🛠️ Installation

1. Clone the repository

   git clone <repository-url>
   cd pdf-editor

2. Install dependencies

   pnpm install

3. Environment Setup

   Create a .env file in the root directory:

   cp .env.example .env

   Generate a secure secret for NextAuth:

   openssl rand -base64 32

   Add the generated secret to your .env file as NEXTAUTH_SECRET.

   Configure your database URLs:

   • DATABASE_URL: Your PostgreSQL connection string
   • DIRECT_URL: Direct database connection (for migrations)

   You can get these from your Supabase project settings.

4. Database Setup

   pnpm prisma:generate
   pnpm prisma:migrate
   pnpm prisma:seed

5. Start Development Server

   pnpm dev

   Open http://localhost:3000 in your browser.

📝 Available Scripts

• pnpm dev - Start development server with Turbopack
• pnpm build - Build the application for production
• pnpm start - Start production server
• pnpm lint - Run ESLint
• pnpm format - Format code with Prettier
• pnpm prisma:generate - Generate Prisma client
• pnpm prisma:migrate - Run database migrations
• pnpm prisma:seed - Seed the database
• pnpm prisma:studio - Open Prisma Studio
• pnpm prisma:setup - Complete Prisma setup (generate + migrate)

🏗️ Project Structure

src/
├── app/                 # Next.js app router pages
├── components/          # Reusable React components
├── hooks/              # Custom React hooks
├── lib/                # Utility libraries and configurations
├── providers/          # React context providers
├── styles/            # Global styles
├── types/             # TypeScript type definitions
└── utils/             # Utility functions

🔧 Configuration

The project uses several configuration files:

• next.config.ts - Next.js configuration
• tailwind.config.js - Tailwind CSS configuration
• eslint.config.mjs - ESLint configuration
• prisma/schema.prisma - Database schema

Test data

User with customer role:

• email - user@gmail.com
• password - user1234

🧪 API Testing with Postman

Follow these steps to test the authentication endpoints:

A. User Registration

1. Open Postman and create a new request
2. Set method to POST
3. Enter URL: http://localhost:3000/api/auth/registration
4. Go to Body tab → select raw → choose JSON
5. Enter the following JSON:

{
  "name": "Test User",
  "email": "test@example.com",
  "password": "123456"
}

6. Send the request → should return 201 Created

B. User Login via NextAuth

1. Create a new request
2. Set method to POST
3. Enter URL: http://localhost:3000/api/auth/signin/credentials
4. Go to Body tab → select raw → choose JSON
5. Enter the following JSON:

{
  "email": "test@example.com",
  "password": "123456"
}

6. Send the request → server will return session or token (if JWT is configured)

C. Get Session Information

1. Create a new request
2. Set method to GET
3. Enter URL: http://localhost:3000/api/auth/session
4. Add session cookies from step B (Postman will automatically save them if Interceptor is enabled)
5. Send the request → returns information about the current user

📝 Important Notes

Make sure your .env file contains:

NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your_long_random_secret_string

For CredentialsProvider in NextAuth, the email and password must match your Prisma database records

🔧 Troubleshooting

• Ensure the development server is running (pnpm dev)
• Check that the database is properly configured and migrated
• Verify that the test user exists in the database before attempting login

TEST CARD

Number: 4242 4242 4242 4242 Expiration: 12/25 CVV: 123