🐦 Twitter Clone — Backend Server

A scalable Twitter/X Clone backend server built with TypeScript, GraphQL, Prisma, PostgreSQL and Redis — featuring JWT authentication, AWS S3 file uploads and a production-ready GraphQL API.

---

📌 Table of Contents

• Features
• Tech Stack
• Architecture
• Getting Started
• Environment Variables
• API Overview

---

✨ Features

• 🔐 JWT Authentication — Secure token-based login and session management
• 📝 Tweet CRUD — Create, read, update and delete tweets
• 👥 Follow / Unfollow — User follow system with feed generation
• 🖼️ Image Uploads — AWS S3 integration with pre-signed URLs
• ⚡ Redis Caching — Session and feed caching for high performance
• 🌐 GraphQL API — Flexible and type-safe API with Apollo Server
• 🗄️ PostgreSQL + Prisma — Relational database with type-safe ORM

---

🛠️ Tech Stack

Layer	Technology
Language	TypeScript
Runtime	Node.js
Framework	Express.js v5
API	GraphQL (Apollo Server)
ORM	Prisma v7
Database	PostgreSQL
Cache	Redis (ioredis)
Auth	JWT (jsonwebtoken)
File Storage	AWS S3 (pre-signed URLs)
Build Tool	tsc-watch + nodemon

---

🏗️ Architecture

Twitter_Server/
├── src/
│   ├── app/              # Express + Apollo Server setup
│   ├── graphql/          # Type definitions & resolvers
│   ├── services/         # Business logic layer
│   └── index.ts          # Entry point
├── prisma/
│   └── schema.prisma     # Database schema
├── tsconfig.json
└── package.json

---

🚀 Getting Started

Prerequisites

• Node.js v18+
• PostgreSQL
• Redis
• AWS S3 Bucket

Installation

# Clone the repository
git clone https://github.com/harshalsakhare2305/Twitter_Server.git
cd Twitter_Server

# Install dependencies
yarn install

# Generate Prisma client
npx prisma generate

# Run database migrations
npx prisma migrate dev

# Start development server
yarn dev

---

🔑 Environment Variables

Create a .env file in the root directory:

DATABASE_URL=postgresql://user:password@localhost:5432/twitter_db
REDIS_URL=redis://localhost:6379
JWT_SECRET=your_jwt_secret
AWS_ACCESS_KEY_ID=your_aws_access_key
AWS_SECRET_ACCESS_KEY=your_aws_secret_key
AWS_REGION=your_aws_region
AWS_S3_BUCKET=your_s3_bucket_name

---

📡 API Overview

This server exposes a GraphQL API at /graphql.

Key Queries & Mutations:

Operation	Type	Description
getUser	Query	Fetch user profile
getTweets	Query	Fetch tweet feed
createTweet	Mutation	Post a new tweet
followUser	Mutation	Follow a user
unfollowUser	Mutation	Unfollow a user
getSignedURL	Query	Get AWS S3 pre-signed URL for image upload

---