Realtime Chat & Threads App

full-stack, real-time messaging application Link : https://testing101-lime.vercel.app/

Screenshots

⚙️ Getting Started

1. Database Setup (Docker)

Ensure you have Docker installed, then run:

docker-compose up -d

This starts a PostgreSQL instance on localhost:8000.

2. Backend Setup

1. Navigate to the backend directory: cd Backend
2. Install dependencies: npm install
3. Configure .env (refer to src/config/env.ts for required variables):

   PORT=5000
   DB_HOST=localhost
   DB_PORT=8000
   DB_NAME=realtime_chat_and_threads_app
   DB_USER=MikasaN
   DB_PASSWORD=ming3465
   CLERK_PUBLISHABLE_KEY=your_key
   CLERK_SECRET_KEY=your_secret
   CLOUDINARY_CLOUD_NAME=your_name
   CLOUDINARY_API_KEY=your_key
   CLOUDINARY_API_SECRET=your_secret

4. Run migrations: npm run migrate
5. Start development server: npm run dev

3. Frontend Setup

1. Navigate to the frontend directory: cd frontend
2. Install dependencies: npm install
3. Configure .env.local:

   NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_key
   CLERK_SECRET_KEY=your_secret
   NEXT_PUBLIC_API_URL=http://localhost:5000/api
   NEXT_PUBLIC_SOCKET_URL=http://localhost:5000

4. Start development server: npm run dev (runs on port 4000)

---

🛠 Techologies Used

Frontend

• Framework: Next.js 15+ (App Router)
• Styling: Tailwind CSS & Shadcn UI
• Auth: Clerk
• State/Realtime: Socket.io Client & React Hooks
• Forms: React Hook Form with Zod validation

Backend

• Runtime: Node.js with TypeScript
• Framework: Express
• Database: PostgreSQL
• Realtime: Socket.io
• File Uploads: Cloudinary & Multer
• Security: Helmet & Cors

📜 License

This project is licensed under the ISC License.